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PREFACE 



The Control Data COMPASS Version 3.6 Assembler provides the user with a versatile, extensive language 
for generation of object code to be loaded and executed on the central processor unit (CPU) or a peripheral 
processor unit (PPU). The assembler executes on the following computer systems and operating systems: 

e NOS 1 for the CONTROL DATA® CYBER 170 Series; CYBER 70 Models 71, 72, 73, 74; and 6000 
Series Computer Systems 

o NOS/BE 1 for the CDC® CYBER 170 Series; CYBER 70 Models 71, 72. 73, 74; and 6000 Series 
Computer Systems 

® SCOPE 2 for the CONTROL DATA CYBER 170 Model 176, CYBER 70 Model 76, and 7600 Computer 
Systems 

The CDC CYBER 170 Models 720 and 730 have unified processors and use the instructions noted in this 
publication for computer models with a Compare/Move Unit (CMU) such as the CYBER 170 Model 172. 

The CDC CYBER 170 Models 740, 750, and 760 have functional units and use instructions noted in this 
publication for computer models with functional units such as the CYBER 170 Model 175. 

This publication is not intended as a replacement for the related computer system reference manuals, 
which contain detailed information on machine instructions. Information in the related computer system 
reference manuals takes precedence over information in this publication should discrepancies arise between 
the publications. 

The reader is assumed to be familiar with a Control Data computer and operating system, and with 
assemblers in general. 



NOTE 

Continued use of COMPASS in creating application programs should be avoided 
when possible. COMPASS and other machine-dependent languages can com- 
plicate migration to future hardware and software systems. Program mobility 
will be restricted by continued use of COMPASS for stand-alone programs, 
COMPASS subroutines embedded in programs using higher-level languages, and 
user-written COMPASS owncode routines in CDC standard products. 

Extended memory for the CDC CYBER 170 Models 171, 172, 173, 174, 175, 720, 730, 740, 750, and 760 is 
extended core storage (ECS). Extended memory for the CDC CYBER 170 Model 176 is large central 
memory (LCM) or large central memory extended (LCME). ECS, LCM, and LOME are functionally equi- 
valent, except as foUows: 

• LCM and LCME cannot link mainframes and do not have a distributive data path (DDP) capability. 

• LCM and LCME transfer errors initiate an error exit, not a half exit, as noted in section 8.4.4. 

The CYBER 170 Model 176 supports direct LCM and LCME transfer instructions. These are described in 
section 8.4.8. 

In this manual, numbers occurring in text are decimal unless otherwise noted. Lowercase letters in formats 
depict variables. The examples assume that assembler numeric mode is decimal and that character mode is 
display code unless otherwise noted. In examples, statements generated by the assembler as a result of a 
call or a substitution are shown in shaded print. 
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General explanations of COMPASS concepts have been limited to the initial pages of each chapter or 
section, whenever possible. Subsequent material has been presented in a concise manner to aid in rapid 
access to reference information. In keeping with this concept, instruction indexes have been included 
inside the front and back covers. 

Additional information essential to programming in the COMPASS environment can be found in the Usted 
publications. Tiie first group consists of software-related publications; the second group consists of 
hardware-related publications. Publications are listed by ASCII collating sequence within each group. 

The applications programmer will need the CYBER Record Manager Basic Access Methods and Advanced 
Access Methods manuals for information about the macros needed to define, access, and manipulate files. 
Diformation necessary to create and manipulate program structures can be found in the appropriate Loader 
reference manual (CYBER Loader for the NOS and NOS/BE operating systems, and the SCOPE 2 Loader 
for the SCOPE 2 operating system). 

In addition to the above, the systems programmer will need the appropriate operating system manual to 
obtain information about system macros. Volume 2 of the NOS reference manual is indispensible for the 
COMPASS programmer in the NOS environment. Further, more detailed descriptions of COMPASS 
instructions can be found in the appropriate hardware reference manual. 

A Control Data abstracts manual is a pocket-sized booklet containing brief descriptions of the contents and 
intended audience of all manuals for a CDC operating system and its product set. The abstracts manual 
can be useful in determining which manuals are of greatest interest to a particular user. The Software 
Publications Release History serves as a guide to the revision level of software documentation which 
corresponds to the Programming System Report (PSR) level of installed site software. 



Software-Related Publications 



Publication 



7000 Record Manager Reference Manual 
COMPASS Version 3 Instant 

CYBER Interactive Debug Version 1 Reference Manual 

CYBER Loader Version 1 Reference Manual 

CYBER Record Manager Advanced Access Methods 
Version 2 Reference Manual 

CYBER Record Manager Basic Access Methods 
Version 1.5 Reference Manual 

Modify Reference Manual 

NOS 1 Reference Manual, Volume 1 

NOS 1 Reference Manual, Volume 2 

NOS Version 1 Manual Abstracts 

NOS/BE i Reference Manual 

NOS/BE Version 1 Manual Abstracts 



Publication 
Number 

60454690 

604U2800 

60481400 

60429800 

60499300 

60495700 
60450100 
60435400 
60445300 
84000420 
60493800 
84000470 



vi 
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Publication 



Publication Number 



CDC CYBER 70 Models 72, 73, and 74 and 6000 Series 60352500 
Computer Systems l/O Specifications Reference Manual 

CDC CYBER 170 Models 172, 173, and 174 Reference Manual 19981200 



CDC CYBER 170 Models 175 and 176 Reference Manual 60420000 
CDC CYBER 170 Computer Systems Models 720, 730, 750, 760 60456100 
CYBER 70 Model 76 Reference Manual 60367200 



CDC manuals can be ordered from Control Data 
Corporation, Literature and Distribution Services, 
308 North Dale Street, St. Paul, Minnesota 55103. 

This product is intended for use only as described 
in this document. Control Data cannot be responsi- 
ble for the proper functioning of undescribed features 
or parameters. 
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SCOPE 2 Loader Version 2 Reference Manual 



60454780 



SCOPE 2 Reference Manual 



60342500 



Software Publications Release History 



60481000 



Update I Reference Manual 



60449900 



Hardware-Related Publications 



Publication 



Publication 
Number 



CDC CYBER 170 Computer Systems Models 171 through 175 
(levels A, B, C) Model 176 (level A) 



60420000 



CDC CYBER 170 Computer Systems Models 720, 730, 740, 
750, 760 Model 176 (level B) 



60456100 



CDC CYBER 70 Computer Systems-7030 Extended 

Core Storage Reference Manual 60347100 
CDC CYBER 70 Model 71 Systems Description and 

Programming Information Reference Manual, Volume 1 60453300 
CDC CYBER 70 Model 72 Systems Description and 

Programming Information Reference Manual, Volume 1 60347000 
CDC CYBER 70 Model 73 Systems Description and 

Programming Information Reference Manual, Volume 1 60347200 
CDC CYBER 70 Model 74 Systems Description and 

Programming Information Reference Manual, Volume 1 60347400 
CDC CYBER 70 Model 76 Reference Manual 60367200 
CDC CYBER 70 Models 72, 73, and 74 and 6000 Series 

Computer Systems I/O Specifications Reference Manual 60352500 
CDC CYBER 70 Models 72, 73, and 74 Instruction 

Descriptions Reference Manual, Volume 2 60347300 



CDC manuals can be ordered from Control Data Corporation, Literature and Distribution 
Services, 308 North Dale Street, St. Paul, Minnesota 55103. 



This product is intended for use only as described 
in this document. Control Data cannot be respon- 
sible for the proper functioning of und^cribed 
features or parameters. 
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INTRODUCTION 



1 



This manual describes the features of the COMPASS Version 3 assembly language processor and the 
principles, methods, rules, and techniques of coding a COMPASS program. 

The user is assumed to be familiar with a Control Data computer and operating system, and is assumed to 
be familiar with assemblers in general. 

Readers with no previous experience with the COMPASS assembler are encouraged to direct their initial 
attention to the following sections of the manual: 

Chapter 1 Introduction 

Chapter 2 Language Structure 

Chapter 3 Program Structure, sections 3.1 through 3.3 

Chapter 4 Pseudo Instructions, sections 4.1 and 4.2 

Chapter 8 or 9 CPU or PPU Symbolic Machine Instructions, the chapter depending upon the 
machine language the user requires 

Chapter 10 Program Execution 

Appendix D Hints on Using COMPASS (example program) 

COMPASS, like other assemblers, is machine- and operating system-dependent. The user, therefore, should 
be aware of restrictions imposed on COMPASS by the programming environment. Specifically, the user 
should note: 

o Differences between CPU and PPU program environments 

• Features of COMPASS not supported by a particular operating system 

Machine and operating system limitations are outlined in the preface of this manual. The applicability of 
instruction sets is shown in the instruction indexes (inside front and back covers), and is addressed as 
necessary throughout the manual. 

A COMPASS program consists of one or more subprograms. From source language subprograms, the 
assembler generates binary output acceptable for loading and execution. The programmer can divide a 
subprogram, whether it is assembled as absolute or relocatable, into areas called blocks. Blocks are 
assembled independently. Thus, they can be loaded and executed independently or linked by the system 
loader preparatory to execution of the program. This capability provides much flexibility in combining, 
segmenting, overlaying, and ordering blocks for execution. 

Subprogram blocks consist of two types of source statements: 

• Symbolic machine instructions 

• Pseudo instructions 

Symbolic machine instructions are the counterparts of the binary machine instructions. They provide a 
means of expressing symbolically the data manipulation functions of the machine. Each symbolic 
instruction typically generates one machine instruction. 
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Pseudo instructions do not have a one-to-one relationship with binary machine instructions. They are used, 
instead, to control aspects of the assembly process, such as: 

• Storage allocation 

• Symbol definition 

• Subprogram linkage 



• Listing options 

• Automatic generation of predefined code sequences (macros) 

From CPU source language subprograms, COMPASS generates absolute or relocatable binary output 
acceptable for loading and execution. From PPU source language subprograms, COMPASS generates 
absolute binai'y output to be loaded and executed on a peripheral processor unit. The operating system 
allows only specially privileged jobs to access a peripheral processor unit. 



Features inherent to COMPASS include: 

Size of source statement fields is largely controlled by user. 



Free-field source 
statement format 

Control of local 
and common blocks 



Programmer and system can designate up to 255 areas to facilitate 
interprogram communication. In CPU programs, common areas can be 
defined in small core memory (CM or SCM) or extended or large core 
memory (ECS or LCM). 



Preloaded data 



Data areas may be specified and loaded in core memory with the source 
program. 



Data notation 



Data can be designated in integer, floating-point, and character string 
notation. It can be introduced into the program as a data item, a constant, or 
a literal. 



Address arithmetic 



• Symbol equation and 
redefinition 

• Symbol qualification 



• Binary control 



• Selective assembly of 
code sequences 



Addresses can be specified making extensive use of constants, symbolic 
addresses, and arithmetic expressions. 

Equation and redefinition of symbols allow extensive parameterization 
of assembly and linkage of subprograms and subroutines. 

Ability to associate a symbol qualifier with a symbol defined within a 
qualified sequence to render the symbol unique to the sequence. An 
unqualified symbol is global and can be referred to from within any sequence 
without qualification. 

The programmer can specify whether binary output is to be absolute or 
relocatable. Absolute coae can be generated for any PPU or CPU. 
Relocatable code can be generated for any CPU. Binary can be written as 
overlays or as partial records. 

Assembly-time tests allow the user to select or alter code sequences. 



• Mode control Ability to specify the base to be used for numeric notation not explicitly 

defined as octal or decimal, and to specify the code conversion to be applied 
to character data as either display code, ASCII, internal BCD, or 
external BCD. 
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e Listing control 



Assembly-time control of list content. 



9 Micro coding Substitution of sequences of characters defined in the program wnenever the 

micro name is referenced. Several micros are predefined by the system for 
user convenience. 



e Macro coding Assembly of sequences of instructions defined in the program or on the 

system library whenever the macro name is referenced. Macro definitions 
can be redefined or purged from the operation code table. 

® Operation code table The programmer can specify or respecify the syntax of a CPU or PPU 

instruction. The assembler generates an entry in the operation code table for 
the instruction. No macro or opdef definition is associated with the entry. 

• Operation code Assembly of sequences of instructions defined in the program or on the 

definition system library whenever an operation code of the specified syntax is 

referenced. 



• Code repetition 

» Remote assembly 

« Library routine calls 

6 Diagnostics 



Sequences of code can be repeated during assembly or at load time. 
Defers assembly of defined coding sequence until later in the assembly. 
Routines can be called from the system library. 
Diagnostics for source program errors are included on output listing. 



1.1 CONFIGURATION 



The hardware requirements for executing COMPASS on a CPU are the minimum required for the operating 
system. 



1.2 ASSEMBLER EXECUTION 

COMPASS is called from the system library by a COMPASS control statement (chapter 10) or FORTRAN 
compiler upon encountering a COMPASS IDENT statement in the source input file. Parameters on the 
control statement specify files used during the assembler run such as the file containing source statements 
and the files to receive listable output and load-and-go output. The COMPASS assemoler executes as a 
CPU program. 

The operating system allocates the input/output resources as needed and performs all input/output required 
during the assembly. 

COMPASS assembles each subprogram on the source file, in turn, in two passes. During the first pass, it 
reads each source language instruction, expands and edits called sequences as needed, interprets the 
operation code, and assigns storage. 

The function of the second pass is to assign block origins, locate literals, fill in all valid symbol values and 
produce the assembly listing and binary output. Finally, it prepares the symbolic reference table and 
reinitializes itself preparatory to assembling the next subprogram. 

COMPASS alters its field length dynamically, thus ensuring that central memory requirements for tables 
used by the assembler are satisfied. The assembler requests additional central memory as needed up to a 
threshold field length. (The threshold value is determined by the installation.) When the threshold field 
length is reached, the intermediate file and cross-references are transferred to the system mass storage 
device. If additional core is needed, the assembler continues to request central memory up to the 
maximum available to the job. (COMPASS may use any ECS/LCM space assigned to the job for table 
space.) If core requirements are still not satisfied, COMPASS aborts and issues a diagnostic message. 
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All nested processing of macros and similar definitions is handled in a single recursive push-down stack. 
COMPASS has a maximum recursion level of 400; that is, COMPASS allows nesting to a depth of 400. 

1.3 RELOCATABLE OBJECT PROGRAM EXECUTION 

When the assembler has completely processed the source deck, a control statement (for example, LGO) can 
be used to call for loading and execution of a CPU object program from the load-and-go file. The loader 
links the newly assembled subprogram to any previously assembled subprograms and subroutines referred to 
l3y the new program and to programs on any other files specified by tiie programmer. After all 
subprograms are loaded and linked, the operating system begins program execution at a location specified 
by one of the subprograms. Data for the object program can be on some programmer-specified file. 
Normally, this loading and execution does not take place if the COMPASS assembler detects fatal errors. 

1.4 INTERACTIVE PROGRAM DEBUGGING 

A COMPASS program that assembles without fatal errors can be executed under control of the CYBER 
Interactive Debug (CID) software. CID allows the programmer to correct errors in program logic from a 
terminal. Using CID, the COMPASS programmer can: 

• Suspend program execution at a specific location or upon occurrence of a specific trap condition, such 
as execution of a return jump instruction 

• Alter location content during program suspension 

• Resume execution at a specified location or at the location where suspension occurred 

A complete description of CID features and use is given in the CYBER Interactive Debug Reference 
Manual listed in the preface. 
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2.1 STATEMENT FOiMAT 

A COMPASS language source program consists of a sequence of symbolic machine instructions, pseudo 
instructions, and comment lines. With the exception of the comment lines, each statement consists of 
a location field, an operation field, a variable field, and a comments field. Each field is terminated by 
one or more blank characters. However, a blank embedded in a character data item, parenthesized 
macro parameter, or comments field does not terminate a field. The size of the variable field is re- 
stricted by the maximum statement size only. Statement format is essentially free field. 

Statements are 80-to-90 column lines. When punched on cards, each card is considered a line. A single 
statement may be composed of as many as ten lines. Information beyond column 72 is not interpreted 
by COMPASS but does appear on the assembly listing. Thus, columns 73-80 can be used for additional 
comments or sequencing. Column 81-90 are used for sequencing by library maintenance programs; they 
are normally not used by the programmer. A line that contains two or more consecutive colons may be 
read and printed as two lines because of operating system conventions for delimiting line images. 

2.1.1 FIRST COLUMN 

The contents of column one designate the type of line, as follows: 

, (comma) Designates the line as a continuation of the previous line, 
♦(asterisk) Designates the line as a comments line, 
other Indicates the beginning of a new statement. 

2.1.2 LOCATION FIELD 

The location field entry begins in column one or two of a new statement line and is terminated by a blank. 
If columns one and two are blank, the location field has no entry. A location field entry is usually 
optional. It may contain a symbol or name according to the requirements of the operation field, or a 
plus sign (+) or a minus sign (-) (section 3.2.4). 

2.1.3 OPERATION FIELD 

If the location field is blank, the operation field can begin in column three. If the location field is 
nonblank, the operation field begins with the first nonblank character following the location field and is 
terminated by one or more blanks. The operation field is blank if there are no nonblank characters 
between the location field and column 30. The following are legal field entries; 

Central processor unit mnemonic operation code and, optionally, the variable subfields with each 
variable subfield preceded by a comma. 

Peripheral processor unit mnemonic operation code 
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Pseudo instruction mnemonic operation code 

Macro name 

Blank 



2.1.4 VARIABLE FIELD 

The contents of the operation field determine if any entry is required in the variable field which consists 
of one or more subfields separated by commas. The variable field begins with the first nonblank 
character following the operation field and is terminated by one or more blanlcs. It is blank if there are 
no nonblank characters between the operation field and column 30. 

A variable subfield contains one of the following: 

Data item 
Expression 
Register designator 
Name 

Special element 

Entry uniquely defined for the instruction 

2.1.5 COMMENTS FIELD 

Comments are optional and begin with the first nonblank character following the variable field or, if the 
variable field is missing, begin no earlier than column 30. The beginning comments column can be 
changed through the COL pseudo instruction (Section 4.4. 5). 

2.1.6 COMMENTS STATEMENT 

A comments statement is designated either by an asterisk in column 1 or by blanks in columns 1-29. 
Comments statements are listed in assembler output but have no other effect on assembly. A statement 
beginning with * is not counted in line counts for IF-skipping (Section 4. 9) and definition operations 
(chapter 5) and is not included in definitions. A statement having columns 1-29 blank is counted. 

2.1.7 STATEMENT CONTINUATION 

Normally, column 72 terminates a source statement that has not yet terminated. However, a statement 
that cannot be contained in the first 72 characters can be continued on the next line by placing a comma 
in column one and continuing the field in column two. A maximum of nine continuation lines is permitted 
for a statement. The break between lines need not coincide with a field or subfield separator; even a 
symbol can be split between two lines. Continuation lines beyond the ninth, and continuation lines 
following a terminated statement are considered comment lines. 
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2.1.8 CODING CONVENTIONS 

Figure 2-1 illustrates a COMPASS coding form that establishes a coding convention as follows: 



Column Contents 

1 Blank, asterisk,or comma 

2-9 Location field entry or plus, or minus left justified 

10 Blank 

11-16 Operation field entry left justified 

17 Blank 

18-29 Variable field entry left justified 

30 Beginning of comments 



All examples in this manual abide by this convention. 



?mmm 


NAME 


mmim 


DATE PAS£ OF 


LOCATION 
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OPERATION 


VARIABLE COMMENTS 
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Figure 2-1. COMPASS Coding Form 
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2.2 STATEMENT EDITING 



COMPASS reads statements in sequence from the source file. It immediately edits and interprets each 
statement unless (1) it is a comments statement of the type indicated by an asterisk in column one, or 
(2) it is part of a definition, that is, it is a statement between a macro or OPDEF header and an ENDM, 
between a DUP or ECHO and an ENDD, or between an RMT pair. Statements within definitions are 
saved for editing and inter pre tat ioa vten the definition is referenced or expanded. ENDD and ENDM 
are part of the definition they terminate and are not edited. Statements v/ithin the range of a conditional 
(IF type) pseudo instruction are edited even when they are skipped. COMPASS performs two types of 
editing: concatenation, and micro substitution. 

2.2.1 CONCATENATION 

COMPASS examines the statement for the concatenation character p* and removes it from any field of 
the statement so that the two adjoining columns are linked. The most common use of the concatenation 
character is as a delimiter for a substitutable parameter name in a macro definition when there is no 
other type of delimiter already there to set off the parameter name. After the substitution takes 
place, the r~*is superfluous and is removed by editing before the definition is interpreted. 

Each removal of n* shifts the remaining columns in the statement left one character. This could 
become significant when comments follow a blank variable field because the comments would be 
shifted left and interpreted as a variable field entr^' rather than comments. 

2.2.2 MICRO SUBSTITOTION 

COMPASS examines the statement for pairs of micro marks (y^) that delimit references to micro 
definitions (chapter 7 ) and replaces each reference (including the micro marks) with the micro character 
string referenced. The string that replaces the reference in the statement can be a different number of 
characters than the reference so that after the substitution, remaining characters in the statement are 
shifted left or right, accordingly. If, as a result of micro substitution, column 72 of the last statement 
read is exceeded, the assembler creates up to a maximum of nine continuation cards, beyond w-hich it 
discards excess without notification on the listing. No replacement takes place if the micro name is 
unknown or if one of the micro marks has been omitted. The micro marks and name remain in the line. 
In the first case, the assembler flags a nonfatal assembly error. However, a single micro mark is not 
illegal and does not produce an error flag. 

If the micro name is null (i. e. , the two micro marks are adjacent) both micro marks are deleted and no 
error flag is set. 

The columnar displacement caused by a micro replacement could also affect the relationship of fields 
to the beginning comments column. For example, it could shift the operation or variable field right 
beyond column 30, or could shift comments left into a blank field. 

A line that contains two or more consecutive colons after editing may be printed as two lines because 
of operating system conventions for delimiting print lines. 

2.3 NAMES 

A name is a sequence of characters that identifies one of the following: 
Subprogram or overlay 
Block 
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Macro definition 
Remote definition 

Duplicated sequence (DUP or ECHO) 

IF sequence 

Micro 

A comma or a blank terminates a name. Concatenation marks and pairs of micro marks are removed 
before the name is scanned (see section 2.2 Statement Editing). 

A CPU subprogram name or overlay name is used for linkage with other subprograms. It must begin 
with a letter (A-Z) and is limited to seven characters maximum. Conventions imposed on names by 
the operating system could restrict the use of certain characters in names. There is no restriction on 
the first character for a PPU subprogram or overlay name. For a CYBER 70/Model 76 or 7600 PPU 
assembly, the name can be seven characters but for a CYBER 170 Series or a CYBER 70/Model 72, 
73, 74 or a 6000 Series PPU assembly it is limited to three characters maximum. In all cases, the 
last character of a subprogram or overlay name camiot be a colon. 

Any other type of name can consist of one to eight characters, A name does not have a value or 
attributes and cannot be used in an expression. 

The different types of names do not conflict with each other. For example, a micro can have the same 
name as a macro, or a subprogram can have the same name as a block, etc. 

2.4 SYMBOLS 

A symbol is a set of characters that identifies a value and its associated attributes. For an ordinary 
symbol, the first character cannot be a $ or = or : or a number; a symbol can be a maximum of eight 
characters. A symbol cannot include the following characters: 

+ - * / blank , F* or a 

Other special characters must be used with care, especially in ECHO and macro definitions (chapter 5). 
Conventions imposed on symbols by the operating system could restrict the use of certain characters 
in symbols. 

An external or entry point symbol is used for linkage with other subprograms and has additional 
restrictions (section 2. 4. 1 Linkage Symbols). 

Concatenation marks or pairs of micro marks are removed before a symbol is examined (section 2. 2 
Statement Editing). In CPU assemblies, to avoid conflict with register designators, a symbol cannot 
normally be An, Bn, Xn, where n is a single digit from zero to seven nor can a symbol be A.x, B.x, 
or X.x, because x is assumed to be a data item by the assembler. However, symbols resembling 
register designators can be used if each use of the symbol is prefixed by =S or =X (section 2. 4. 2). 
Register designators are described further in Section 2.5. 

The process of associating a symbol with a value and attributes is known as symbol definition. This 
can occur in five major ways. 
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1. A symbol used in the location field of a symbolic machine instruction or certain pseudo 
instructions is defined as an address havdng the current value of the location counter (section 
3. 2. 2) and having an attribute defined as follows: 

Absolute for the absolute block 

Common for labeled or blank common blocks (relocatable assemblies only) 
Relocatable for local blocks other than absolute during pass one 
Absolute for local blocks during pass two of an absolute assembly 

2. A symbol used in the location field of definition pseudo instructions (section 4. 6) is defined as 
having the value and attributes derived from an expression in the variable subfield of the 
instruction. Certain of these pseudo instructions assign an attribute of redefinability to a 
symbol. Unless a symbol is redefinable, a second attempt to define it with a different value 
produces a duplicate definition fatal error flag. 

3. An external symbol is defined outside the bounds of the current subprogram, and is declared a£ 
external in the current subprogram or is defined in relation to a sjonbol declared as external. 
In either case it has the attribute of external. Unlike a systems symbol, the true value 
definition is not known to the current subprogram, 

4. Definitions of systems symbols that take place outside of the current program can be 
carried over to the current program through the SST pseudo instruction. COMPASS uses 
the true definitions but assigns the additional attribute of systems symbol. 

5. COMPASS defines a symbol by default if a reference to a symbol is preceded by =S and the 
symbol is not otherwise defined in the subprogram. This feature is further described 

in section 2. 4. 2 Default Symbols. 

There is no restriction on the number of times that the symbol can be referred to in the subprogram. 



Examples ; 



Legal Symbols 

P 
R3 

PROGRAM 



Illegal Symbols 
5A 

ABCDEFGHI 

ABE+15 

=.11 



First character numeric 
Exceeds eight characters 
Contains plus sign 
First character equal sign 



2.4.1 LINKAGE SYMBOLS 

A relocatable subprogram can be linked to other subprograms through linkage symbols. The two types 
of linkage symbols are external symbols and entry^ point symbols. An external or entry point symbol 
can be a maximum of seven characters, the first character must be a letter (A-Z), and the last 
character must not be a colon. 

Any symbol declared as an entry point in a subprogram compiled or assembled independently of the 
current subprogram can be declared as an external symbol in the current subprogram. Any symbol 
declared as an entry point in the current subprogram can be declared as an external symbol in some 



2-6 



60492600A 



other subprogram. The symbol has a zero value and an attribute of external. An external symbol can 
be declared either through the EXT pseudo instruction or through default (a reference to the symbol is 
preceded by =X or =Y; see section 2.4. 2 Default Symbols). 

An external symbol can be -strong or weak. A strong external symbol reference causes the loader to try 
to find and load a subprogram having a matching entry point symbol. Failure of the loader to satisfy a 
strong external in this way is flagged as a non-fatal error by the loader. A weak external does not 
require the loader to search for a satisfying subprogram; however if one is loaded for some other 
reason, the loader associates the matching linkage symbols in the usual way. At the end of loading, the 
existence of unsatisfied weak external symbol references is not an error. 

External symbols can be defined in the subprogram relative to any external symbol declared in an EXT 
pseudo instruction. This is possible through use of symbol definition instructions that assign the value 
and attributes of an expression to a symbol. If the value of the expression reduces to an external symbol 
j- an integer, the location field symbol is defined as having an integer value and external attribute. 
Entry point symbols and external symbols are not qualified (section 2.4.5). 

2.4.2 DEFAULT SYMBOLS 

When a symbol reference is preceded by =S, =X, or =Y and the symbol is not defined in the subprogram, 
COMPASS defines the symbol or declares it as a strong or weak external symbol, respectively, at the 
end of assembly. The =X and =Y forms are defined by default in relocatable assemblies only. 

=Ssymbol If symbol is not defined, COMPASS assigns an address at the end of the zero 

block. All subsequent references to the symbol, whether preceded by =S or not, 
are to the location of the word. A default symibol cannot be used where a 
previously defined symbol is required. 

If the symbol is defined by a conventional method, COMPASS does not define it 
again but uses the programmer definition. 

=Xsymbol This option permits a programmer to define his symbols in a subroutine or link 

to them in another subprogram. If the programmer defines the symbol, the 
assembler uses the programmed definition. If the programmer does not define 
the symbol, the assembler assumes that the symbol is a strong external as though 
declared in an EXT pseudo instruction. A symbol prefixed by =X must conform 
to the requirements for external symbols. 



=Y symbol This option permits a programmer to define symbols in a subroutine or to link 

to them in another subprogram that need not be loaded. If the programmer 
defines the symbol, the assembler uses the programmed definition. If the pro- 
grammer does not define the symbol and if it is not referenced elsewhere with an 
=X or =S prefix, or declared in an EXT pseudo instruction, the assembler 
assumes that the symbol is a weak external. A symbol prefixed by =Y must 
conform to the requirements for external symbols. 

The system does not define a default symbol and issues an error flag if a symbol is prefixed by both 

=S and =X, or is prefixed by =X or =Y, and is not defined conventionally in an absolute assembly. Default 

symbols are qualified by the qualifier in effect at the time of the =S reference. 



2.4.3 PREVIOUSLY DEFINED SYMBOLS 

Certain pseudo instructions require that a sjonbol in an expression be previously defined. This simply 
means that the symbol, before its use as an expression element, must be defined in a prior instruction. 
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2.4.4 UNDEFINED SYMBOLS 



A reference to a symbol that is never defined (not even by default) causes a U error flag to be placed to 
the left of the instruction containing the erroneous reference. 

2.4.5 QUALIFIED SYMBOLS 

A symbol defined when a symbol qualifier is in effect during assembly (section 4,4,3) can be referred 
to outside of the qualifier sequence in which it was defined through: 

/qualifier/symbol 

The feature permits the same symbol to be defined in different subroutines without conflict. An 
unqualified symbol is global and does not require a qualifier when it is referenced, unless a qualifier 
is in effect, and a symbol qualified by the same qualifier has been defined. In this case, the unqualified 
symbol can be referenced as // symbol. r 

The combination of qualifier and symbol permits a value to be identified by a unique 16-character 
identifier. Linkage symbols are not qualified. 



2.5 CPU RiGISTiRS 

Register designators sjrmbolically represent the 24 CPU operating registers. These registers are 
described more fully in chapter 8. The designators are inherent to COMPASS and cannot be changed 
during assembly. 

In a CPU assembly, symbols of the same form as register designators may be used if each occurrence 
of such a symbol is prefixed by =S, =X, or =Y (see section 2.4. 2). However, a warning message is 
issued when such symbols are defined. The prefix cannot be used in the location field of machine 
instructions and symbol defining, data generating, BBS pseudo instructions, in the variable field of 
ENTRY, EXT, and SST pseudo instructions. 

Register T3rpe Designator 

Address An or A. n 

Index Bn or B. n 

Operand Xn or X. n 

For the forms An, Bn, or Xn, n is a single digit from to 7. Any other value for n, for example 8, causes 
An, Bn, or Xn to be interpreted as a symbol rather than a register designator. 

For the forms A.n, B.n, X. n, n can be a symbol or an integer. If the value of n or the value of the 
symbol exceeds 7, the assembler truncates it to the least significant 3 bits and issues a warning flag. 

Registers designated by Al through A5 or A. 1 through A. 5 are used for addressing to obtain information 
from central memory. Registers designated by A6, A7, A. 6, or A. 7 are used for addressing to place 
information into central memory. 
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COMPASS does not recognize registers in PPU assemblies; there, the designators are acceptable as 
ordinary symbols. 



Examples: 

Al Designates address register 1 

AlO Interpreted as a symbol, not a register 

A.l Designates address register 1 

A. NUM If the value of NUM is 6, it designates address register 6 

A. 10 Designates address register 2; however, it produces a warning flag because the 
two was derived from the truncation of 12, the octal value for 10. 



The following produce equivalent results. A SET pseudo instruction (section 4. 6. 2) defines SUM and 
SUB as absolute values 3 and 2, respectively. A reference to a SET-defined symbol produces the same 
result as if the value had been used directly. In this example, the address of ALPHA is 001000. 
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Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




It 


18 i30 


60320Q1000 






S83 


A24-fiLPHA [ 






lOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




11 


18 ho 


2 

6032001000 




SUH 
SUP 


SET 
SET 

se.suH 


3 1 
2 ! 
A.SUR+AL^HA 1 



2.6 SPECIAL ELEMENTS 

The following designators are reserved for use as references to special elements and cannot be used as 
symbols. The use of a special element in an expression causes the assembler to replace it with a 
value specified by the element in the expression. The control counters are discussed further in 
section 3. 2. 

Designator Significance 

* or *L The assembler uses the value of the location counter for the block in use. 

The element is relocatable unless the counter in use is for the absolute block. 

*0 The assembler uses the value of the origin counter for the block in use. The 

element is relocatable unless the counter in use is for the absolute block. 

$ The assembler uses one less than the absolute value of the position counter 

for the block in use, 

*p The assembler uses the absolute value of the position counter for the 

block in use. 

*F The assembler uses an absolute value obtained as follows: 

COMPASS was called by a COMPASS control statement 

1 COMPASS was called by a RUN-type compiler 

2 COMPASS was called by a FTN-type compiler 

These designators are inherent to COMPASS and caimot be altered by the programmer during an 
assembly. 
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Examples: 





lOCATlON 


OPERATION 


VASIABIE COMMENTS 


I 




n 


18 i30 






JO 


1 








1 

X3,*L-1 1 
1 






] 

LOC 


j 
1 








1 

♦P/ 1 






VFl 


1 

1 

$/.,!/! 1 








i 



2.7 DATA MOTATSOM 

Data notation provides a means of entering values for calculation, increment counts, operand values, 
line counts, control counter values, text for printing mt messages, characters for forming symbols, 
etc. 

The two types of data notation are character and numeric. The assembler allows the user to introduce 
data in the prc^ram in three basic ways. 

As a data item 

As a constant in an expression 
As a literal 

2.7.1 DATA ITEMS 

Character and numeric data items can be used in subfields of the DATA (section 4. 8. 2) and LIT 
(section 4.8.4) pseudo instructions or as specifications of field lengths on VFD pseudo instructions. 

2.7.2 CONSTANTS 

A data constant is an expression element consisting of a value represented in octal, decimal, 
hexadecimal, or character notation. It resembles a data item but is restricted by its use as an 
expression element in two ways: 
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1. The first character must be numeric, prohibiting the delimited type of character string 
(section 2.7.4) and the preradix for numeric values. 

2, The field size is determined by the destination field for an expression and can be a maximum 
of 60 bits thus prohibiting double precision floating point numbers. 

2.7.3 LITERALS 

A literal is a read-only constant. It is specified as a data item in a subfield of a LIT pseudo instruction 
or as an element in an expression. 

The method of specifying a literal in an address expression is nearly identical to that for specifying a 
data item in a DATA (section 4. 8. 2) or a LIT (sectioii 4. 8. 4) pseudo instruction. The primary difference 
is that the literal is prefixed with an equal sign, which indicates that a literal follows. 

When a literal is used as an element in an expression, the expression is evaluated using the address of 
the literal in the literals block rather than the value of the data item. Thus, the literal is considered 
relocatable. (For a discussion of the literals block, see section 3,1.3)« 

Conventionally J if a literal is used, it is the only element in an expression. 

The first use of a literal causes the assembler to assemble the data specified by the literal, and store 
the data in the literals block using as many words as are required to hold the data. If the binary pattern 
of the prefixed type of literal or of all the literals in a LIT declared sequence matches the binary 
pattern of words previously entered in the literals block, an entry is not generated for the 
data. This process eliminates duplication of read-only data. 

The LIT pseudo instruction permits symbols to be associated with literals block entries, aich entries 
can be referenced symbolically or through use of a prefixed literal. However, to preserve the integrity 
of the literals block, they should be used as read only locations. 

The assembly listing includes a list of the literals block when the D list option is selected (section 4. 11. 1). 
Example: 

In the following example, using CPU instructions, the first statement creates a word in the literals 
block having the value 00000000000000000001. The address of that entry (for the purpose of the 
example) is 5555 and is used in the address field of the two statements at address 100 and the state- 
ment at the lower part of 101. 

The literal in the second statement specifies a right justified character. A, which has a display code 
value of 1. The SB4 creates a one-word literal block entry having the value 00000000000000000002. 
The address of that entry is in the address field of statements at the upper half of addresses 101 
and 102. In this example, the LIT sequence duplicates a sequence of entries in the literals block 
and does not cause new entries to be assembled. 
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Location Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




11 


18 


|30 










100 6120005555 * 






S82 


= 1 


1 


6130005555 -»■ 






SB3 


= 1RA 




101 61<*O0Q5556 + 






SBi* 


= 1PR 


! 


5555 




L 


LIT 


1»? 




6120005555 4- 






SB2 


L 


1 


102 6130005556 + 






SB3 


Lfl 


I 



CONTENT OF LITERALS EtOCK, 



005555 ooooooonoonoooaoooni ft 

005556 OOOOOOOCOOOTOOOOOOn? B 

Continuing the previous example, a LIT sequence as illustrated below, does not duplicate a sequence in 
the literals block and causes entries to be generated in the literals block: 



Location 


Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






1 




11 


18 


ho 




5557 






LIT 


I, -^,190,2 1 

1 



I 



CONTENT CF LITERALS ELCCK. 



00555^^ oonoooooonoooooooooi a 

00555<s nnmonnnonooonnnaoo2 b 

005557 noonooonooonoononooi ft 

00556T onoonQQfinno^rionoooo3 c 

05^61 Qomoonnooonooooooof* 

005562 onnnooonoooooonoooQ2 b 



However, if the literals sequence in the first part of the example had been followed by a LIT that 
duplicates, in part, the most recent entries in the literals block, only the unduplicated part is added 
to the block. Thus, if the following LIT sequence had been used in place of the LIT 1,S,1RD,2, the 
first two words of the sequence would match the last two words of the literals block so that only two 
additional words would be required to complete the sequence. 



Location Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


5555 


t 




11 


18 !30 






LIT 


1,2,3,1, } 



CONTENT OF LITERALS BLOCK, 

00555^=^ onnnnooroooononoonoi a 

00555<=) OOOnnOO'^OO'OOOOOOQOO? B 

0055*^'' ono'^ooonoQCfinnnnooo? r 

05560 ooooooononononoonoQit n 
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2.7.4 CHARACTER DATA NOTATION 



Character data strings are converted to the code in use at the time the string is evaluated (section 4,4. 2, 
CODE pseudo instmction), and placed in a field indicated hy the data type (data item, constant, or 
literal). Wlien no CODE instruction has been issued, conversion is to display code representation. 



Format: 

Data Item 

Constant 
Lite rait 



sign 


n 


type 


string 








or 






sign 


type 


d 


string 


d 



n 


type 


string 


















sig-n 


n 


type 


string 








or 








sign 


type 


d 


string 


d 



Example 
-3RABC 

-R*ABC* 

3RABC 

=-3RABC 

=-R*ABC* 



- Applies to literals used as expression elements only; signifies that a literal follows. 

sign Optional for data item or literal. A sign with a constant is interpreted as an element 
operator. 

+ or omitted The value is positive 

The complemented (negative) value is formed 
n Signifies how the string is determined: 



omitted 




The string is delimited by d. n cannot be omitted for a constant. 

For data item or literal, the string consists of all characters following 
type to : 

blank or , 

For a constant, string consists of all characters following type to: 

+ - * / blank , or A 

For a data item or literal, n is an integer count of the number of 
characters in the string not counting guaranteed zeros. It is limited 
only by statement size. 

For a constant, n is an integer count of the number of characters in the 
string. It cannot exceed 1/6 of the number of bits in the field that will 
contain the expression. A tmncation error is flagged for a right 
justified constant if the most significant bit exceeds the field. Tnmcated 
zeros do not cause an error in this case. A truncation error is flagged 
for a left justified constant if the least significant bit positions are 
truncated, even if they are zero. 

The string consists of the n characters following type. 
Regardless of base, COMPASS assumes that n is decimal. 



t Expression element 
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Character string justification. The characters formed by the data item 
or constant are right or left justified into the destination field as follows: 

Type Significance 

C Left justified with zero fill. For data item or 

literal, 12 zero bits are guaranteed at the end of 
the string even if another word must be allocated. 
For a constant, C is the same as L; the 12 zero 
bits are not guaranteed. 



H Left justified with blanl^ fill 

A Right justified with blank fill 

R Right justified with zero fill 

L Left justified with zero fill 

Z Left justified with zero fill. For data item or 

literal, six zero bits are guaranteed at the end of 
the string even if another word must be allocated. 
For a constant, Z is the same as L; the six zero 
bits are not guaranteed. 

A delimiting character used only when n is omitted. The characters 
between the first occurrence of d and the second occurrence of d form the 
string, d can be any character other than r* or 

Characters from one of the COMPASS character sets (appendix A), except 
for those characters that act as delimiters (see n and d), the concatenation 
character (r*), and pairs of micro marks 

Concatenation marks and pairs of micro marks are removed by editing 
before a string is examined. A single micro mark can be used in a string. 

An empty or omitted character string is defined under one of the following 
conditions: 

• n is and type is immediately followed by a delimiter, for 
example, OL. 

• n is omitted and the two delimiting characters are adjacent, for 
example, H++. 

Omission of a string in a DATA pseudo instruction is legal and does not 
cause generation of a data word. 

For a constant, an omission of the string is valid and has a zero value. 

An omitted string in a LIT pseudo instruction is legal and does not cause 
generation of a literal for that item; however, the LIT must contain at 
least one non-empty data item. 

An omitted string for a literal in an expression is not legal and produces an 
error. 

It is not possible to generate empty strings using types C, Z, R, or A. 
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Examples of character data: 

In these examples, characters are converted to display code representation; all lines of code 
generated by DATA are printed only if the D or G list option is selected. 

Data Items 



Location 



Code Generated 



lift* 052e22172?551116^520 

0£*?tc?5orQonnGOoonnon 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 !30 
















L^ERKOR 


IN POQ L. . , iOH 



Location 



1100 
1101 
1102 



Code Generated 



1725 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




1! 


18 bo 






PPU 
DATA 


1 

i 
1 

OLOUTPUT j 



Constants 



Location Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 ho 








; ■' 1 ■ ' ' ■ 


^♦722 


7130Q000i+7 






SX3 


IR* 


1 


'♦723 


71^+0000060 




TAG 


bX£+ 


IRf*. +■ i 


1 
1 




5110031117 






SAl 


3RCI0 


1 


'♦72^ 


6260530000 






S8o 


X0+-1L2 


1 




11172^+0155 






VFU 


3Q/i+HlO 


1 A ,6/lKA , 2£*/UAX + l 


^♦725 


0155555531 










1 




17252i+2025 






VFD 


^+2/01. OUTPUT, 18/1 


'f726 


24+00000001 














0700030000 






VFD 


15/OLG, 


15/0L| 



Note that the character constant in the expression in the second line consists of a decimal point 
(57 in display code) to which 01 is added before the value is stored. Similarly, in the third field 
of the first VFD, 1 is added to the display code representation of X right justified with blank fill 
(55555530) so that 55555531 is generated. 
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Literals 



Location Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


) 




H 


18 ho 










100003765 




TflGl 


LIT 


Ra^-'^/ (A ,6L) s= ,.,ocn,OL 


100003770 






LIT 


^OHLITERALS 


2652 51100Q3772 






SAl 


^OCTENCHARCTS 


512000377^+ *■ 






Sfl? 


-M+LFFT JUSTIFY WITH PLANKS+ 


2653 5130003767 + 








= 0L0 



CONTENT OF LITERALS BLOCK. 



03765 0000000000i»5it6i+7505 1 

003766 52535i+555657000 00 ) 

003767 33000O000noa00Q00000 

003770 lf»ll?i+052?0 11^+235555 LITERALS 

003771 55555555555555555555 

003772 2i+0516n3inoi22n32i+23 TFNCHARCTS 
00^773 OOOnOOODOOOOQOOOOOOO 

0377^+ lttn5Q62i*551225232<tll LEFT JUSTI 

003775 063155?711?f*1055Q21U FY WITH PL 

003776 01161323555555555555 AMKS 



The first LIT pseudo instruction generates three words in the literals block; the OL item is an empty 
string and does not produce an entry. The second LIT pseudo instruction generates one two- word 
entry. The expressions in the variable. fields of the SAl, SA2, and SA3 instructions each consist of a 
literal element. The character strings in the SAl and SA2 literals do not duplicate former literals 
block entries so COMPASS generates new entries. However, since SA3 references an existing entry, 
COMPASS places the address of the entry in the address field of the instruction. 



2.7.5 NUMERIC DATA NOTATION 



Numeric data can be specified in octal or decimal notation. The value is converted to an integer or a 
floating point value in single or double precision. 



Formats : 
Data Item 
Constant 
Literal 



sign 


pre radix 


value 


modifiers 



value 



modifiers 





sign 


pre radix 


value 


modifiers 
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sign 



preradix 



Applies to literals only; signifies that a literal follows. 

Optional for data item or literal; a sign with a constant is interpreted as an element 
operator, 

+ or omitted The value is positive 

The complemented (negative) value is formed 

Optional for data items and literals; cannot be used for constants. The preradix 
indicates the notation used for the value. 



omitted 

B or O 
D 



Notation can be specified by a postradix modifier or can be 
assumed from the assembly base. See BASE pseudo instruction. 

Octal notation 

Decimal notation 



value 



modifiers 



A series of octal or decimal digits optionally consisting of an integer, a decimal (or 
octal) point, and a fraction. An integer value (fixed point) does not contain a point. 
A floating point value (legal in CPU assemblies only) is noted by the occurrence of 
the point. 

An octal value can be a maximum of 20 significant digits (fixed point) or 32 significant 
digits (floating point). An octal value cannot include 8 or 9. A decimal value cannot 
exceed 1. 15 x lO^^ (fixed point) or 7o 9 x lO^S (floating point, ignoring the decimal 
point). Extra significant digits cause erroneous results. 

If value is omitted, it is assumed to be zero. 

Associated with the value are the following optional modifiers specified in any sequence. 
A specific type of modifier can be specified only once, A duplicate produces an error 
flag. 



postradix 
decimal exponent 



Indicates the notation used for the value. See preradix for legal values. 
An error is flagged if notation contains both a preradix and a postradix. 

Defines a power of 10 scale factor 

E+n or En or E Single precision 

EE+n or EEn or EE Double precision 

When the sign is plus or is omitted, the exponent (n) is positive. 

When n is omitted, it is assumed to be 0. The value of n cannot exceed 
32767 and is always assumed to be a decimal integer. 

A fixed point value can be single precision (one word) only but a CPU 
floating point value can be generated in double precision (two words). 

If EE is used with a fixed point value, the assembler produces a fixed point 
number in single precision. 

The effect of the exponent is to multiply the value by 10 decimal raised 
to the n power. 



^ 
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binary scale Defines a power of two scale factor and is specified as follows: 

S+n or Sn or S 

When the sign is plus or is omitted, the scale factor (n) is positive. When 
n is omitted, it is assumed to be 0. The value of n cannot exceed 32767 
and is always assumed to be a decimal integer. 

The effect of the binary scale is to multiply the value by 2 raised to the 
n power. 

Applies to floating point values only and is specified as follows: 
P+n or Pn or P 

When the sign is + or omitted, n indicates the number of bit positions 
the point is to be shifted to the left of bit 0. When the sign is -, n 
indicates the number of bits the point is to be shifted to the right. 

The effect of P is to align the value so that the binary point occurs to the 
right of the nth bit. 

The exponent is adjusted to a value of - (+n) 

For example, a value with P-6 will have a biased exponent of 2006g; a 
value with PIO will have an exponent of 1765g. 

If P is not specified for a floating point number or if n is omitted, the 
assembler generates a normalized floating point value. The P modifier 
permits generation of an unnormalized value. 

If, as a result of P, the most significant bit of the value is shifted out of 
the coefficient part of the single or double precision number, the assembler 
generates an overflow or underflow error. 



binary point 
position 



Although scale factors can exceed valid ranges, the ranges for numbers are restricted 
by the hardware. 

Example : 

qo 

The number 1. 0E4000S-1200 yields a number that is approximately 5. 8 x 10 
and is in range of the floating point representation. 

All calculations are performed in 144-bit precision. The values are rounded to 96 
bits for double precision and to 48 bits for single precision floating point numbers and 
to 60 bits for integers. 

The order in which the assembler acts on the modifiers, regardless of the sequence 
in which they are specified is: 

1. Decimal exponent (single or double) 

2. Binary scaling 

3. Binary point position (CPU assemblies only) 
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CPU Numeric Efeta Items 



Location 



Ckxie Generated 



SOOO 777777777777777777h? 

50Q1 i72350ononooQononnoo 

■5002 16't30QOOOOOOOOnOflO OQ 

5003 20000000000000000012 

5004 17760000000000000002 

5005 17l5i*6517676355i+i*26'f 

5006 i720031it631i^631%631Jf 

5007 777777777 7777777 77 7 7 
5010 QOOOQOOOOOOOQQOOOOOQ 



tOCATlON 



POOL 
NUH 



OPERATION 



DATA 
DATA 

DATA 
nATA 
DATA 
DATA 



VARIABLE 



COMMENTS 



130 



-29 , 
l.OEEl I 

1,0F4-1P0 j 
3.2P1S-5E1 
Q.0151E4-01 I 
0.1P47,-E,DEES 



CPU Numeric Constants 



Location Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 








11 


18 


Uo 












5001 ♦ 




ALPHA 


EQU 


POOLfl 




555 




VAL 


EQU 


5558 




5012 






PSSZ 


lOOP 




5112 20360 






LXl 


-l^^R 




t*37bQ 






HX7 






7150«*00000 






SX5 


1S17 




CPU Numeric Literals 










Location Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 








!l 


!8 


|30 












5113 5150005151 + 






SA5 


= 2 0O£*6755OO0 234QOO0 0itP 


5130005152 + 






SA3 


= 1.1 


1 


5153 




APLE 


LIT 


l.OEEl 


1 


5155 






LIT 


0, lPi*7 




5156 






LIT 


«01Q 


1 


5157 






LIT 


.0151E + 01 


,-E,DEES 



CONTENT OF LITERALS ELOCK. 



005151 200%675500023%OQOOO«* PDa B1 

005152 1720tj31ij631'*631i+6315 0PeL«LlL8M 
Ot35153 17235QSQ00?5O00QQ00Q0 OS/ 
0Q515i» 16«*300OO0OO000O0O0O0 NB 

005155 1720031i*631i^631f*631i* OPCLtLtLSL 

005156 77777 777777777777 75 <♦ ? : ? ; I ? I ? 1= 

005157 1715«»6517676355tj«f afet* 0M-("'"'2 = 7# 

005160 77777777777777777 777 

005161 OOQQOQOOOOOOOOOODQOO 
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Examples of numeric data (assume default radix is decimal): 
PPU Data Items 



Location 



300 
301 
302 
303 
30t» 



Code Generated 



0005 
7766 
0013 
0030 
0002 





lOCATlON 


OPERATION 


VARIABLE COMMENTS 


I 




)1 


18 bo 






PPU 

• 

• 

• 

O&TA 


i 

1 

: 1 

5,-9D,+813,l<»8Sl,2i»BE-l 

1 



PPU Constants 



Location 


Code Generated 






LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




n 


18 


Iso 










315 


oono 








COM 


Q ,+1 1 


i 


306 


0011 












1 


307 










COM 


"33 3*+ 


1 






31 




fipr 












101 






SET 


0101 


1 


310 


nil 










nil 


1 



PPU Literals 



Location Code Generated location operation variable comments 

1 n ~% Tao 



311 2000 1103 LOG =10D 

313 2100 110** fiOC --1 

316 2000 1105 toe =7777 



CONTENT OF LITERALS BLOCK, 

1103 0012 J 
110i» 7776 

1105 7777 n 
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2.7.6 HEXADECIMAL DATA NOTATION 



Numeric data can bo specified in hexadecimal notation. The value Is converted to an integer in single 
precision. 

Formats: 
Data Item 



Constant 



Literal 



sign 



preradix 



preradix 



sign 



value 



value 



modifiers 



modifiers 



preradix 



value 



modifiers 



sign 







preradix 
value 



modifiers 



Applies to literals only; signifies that a literal follows. 

Optional for data item or literal; a sign witti a constant is interpreted as an element 
operator. 

+ or omitted Value is positive. 

Complemented (negative) value is formed. 

The zero is optional for data items and literals but must be present for constants, so 
the preradix will not be taken as the first character of a symbol. 

Must be present to indicate that a hexadecimal value follows. The preradix character 
is = or # depending on the printer used. 

A series of hexadecimal digits. Each hexadecimal digit represents 4 bits and is either 
a decimal digit 0-9 or a letter A-F. The digits 0-9 represent values 0-9 and the letters 
A-F represent the decimal values 10-15. 

The value may contain up to 26 significant hexadecimal digits. No radix point is 
permitted. If value is omitted, it is assumed to be zero. 

The binary scale (S) modifier is optional and has the same form and meaning as for 
octal and decimal data (see section 2. 7. 5). 

The binary point position (P) modifier is permitted but ignored, since it does not 
apply to integer values. 



Examples of hexadecimal data: 

Location Code Generated 

0(50 0U«*352?'i* 

1 77777777777777777777 

2 77777777?77775252525 

3 OOOOOOOODOO ll06f^00U0 
^ 0OO0OOO0Di}OC53012p6fe 

5 713300^036 ^ 

6 77;'77777777776671353 





lOCATIOK! 


OPERATION 


. VARIABLE COMMENTS 


1 




1! 


18 ho 




X 

HEX 

CONTtNT 


DATA 

CO:>l 
SX3 

OF LIT 


: i 

E123A3C,-E,-0 5AAAAA ,=1234512 
I 
1 
I 
1 
1 

0rAGl676 { 
= - = 123^4552; 

£RALS ^BLOCK, i 
1 
1 



2.8 EXPiiSSiOnS 

Entries in subfields of most source statements are interpreted as expressions consisting of a combina- 
tion of one or more terms. Each term consists of one or more elements joined by operators. A comma 
or a blank terminates the expression. 

An expression element can be a: 

Symbol 

Numeric or character constant 
Special element 



Register designator (CPU only) 
Literal 



60492600 C 



2-21 



Examples of elements: 



ALPHA 
*p 



A. 7 

X3 

77BS3 



3HABC 

=10HOUTPUT 



A term can be a single element or two or more elements joined by the following element operators: 

* Multiplication 
/ Division 

An expression can be a single term or two or more terms joined by the following term operators: 

+ Addition 

Subtraction 
A Logical minus (exclusive or) 

The exclusive or operator is printed as a (carat) in the CDC character set or as 85 (ampersand) in 
the ASCII character set. 



1. If the last element of a term is omitted, COMPASS provides an element of zero. For example, 
if ABLE is a sjonbol, ABLE*+3 is interpreted as the value of ABLE times plus 3. 

2. Two successive elements are illegal. Note, however, that ** is legal because the first 
asterisk is interpreted as an element, the second asterisk is interpreted as an operator, and 
the blank is interpreted as a null element. 

3. A term can contain one relocatable or external element only. Thus, **ABLE, where ABLE is 
a relocatable address, is illegal because ABLE and * are both relocatable. 

4. The element to the left of a divisor must be absolute. 

5. Division by zero results in zero with no error. 

6. Two or more additive operators (+ or - or A ) in sequence are interpreted as having a term of 
zero value between them. 

7. If an expression begins with an additive operator (+ or - or a), COMPASS provides a term with 
zero value preceding the operator. 

8. All arithmetic in expression is performed in integer mode, even if an element is a floating 
point constant such as 2.3. Results are restricted to 60 bits; that is, if a term or value 
exceeds 60 bits, the excess high-order bits are discarded without comment. 

The operator that immediately precedes a register designator is the register operator, regardless 
of the placement of the designator in the expression. The register operator can be: 

+ - * or / 

Examples of expressions: 

*8LE Single term 

*-29 Two terms; $ and 29 



Rules: 
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l-«- = 3 . l^tlSgEE + e Two terms; a constant and the address of a literal. COMPASS places the 
literal in the literal block and uses its address in the expression. 

3 Two terms; value of the location counter and numeric constant 3. 

A8LE*tf-72/NUM Two terms, each consisting of two elements; the value of ABLE times 4, 
and 72 divided by the value of NUM. 

10 B Single term consisting of a numeric constant. 

34-A6-NUM The components of the expression are register A6 and 3-NUM. 

1R = A1R/ The character constants (= and/) are logically differenced. 

2.8.1 TYPES OF EXPRESSIONS 

Evaluation during assembly reduces an expression to: 

An absolute value (absolute address or an integer value) 
An external symbol + a 21-bit integer 
+ relocatable value + a 21-bit integer 
Register designators and one of the above 
Register designators 



1 



CPU assembly only 



Absolute Expressions 

An expression is absolute if its value is unaffected by program relocation. An expression can be 
absolute, even though it contains relocatable terms, under these two conditions: 

1. The expression contains an even number of relocatable elements 

2. The relocatable elements must cancel each other. That is, each relocatable element (or 
multiple thereof) in a block must be canceled by another element (or multiple thereof) in the 
same block. In other words, pairs of elements in the same block must have signs that oppose 
each other. The elements that form a pair need not be contiguous in the expression. 

Examples of absolute expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. 
The control counters are for the block that contains EASY and FOX. 

EASY-FOX +M IKE EASY and FOX cancel each other. 

FOX-* FOX and the location coimter cancel each other. 

MIKF + i6 The expression contains no relocatable elements. 

£ASY-^F0X*2 + * EASY and the location counter cancel 2 times FOX. 
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Relocatable Expressions 



An expression is relocatable if its value is affected by program relocation. A relocatable expression 
consists of a single relocatable terra or, under these two conditions, a combination of relocatable and 
absolute terms: 

1. The expression does not contain an even number of relocatable elements 

2. All the relocatable elements but one must be organized in pairs that cancel each other. That 
is, for all but one block, each relocatable element (or multiple thereof) in a block must be 
canceled by another element (or multiple thereof) in the same block. The elements thac form 
a pair need not be contiguous in the expression. 

3. The imcanceled relocatable element can have three kinds of relocation: 

a. Positive program 

b. Negative program 

c. Positive common (Negative common relocation is not permitted by the loader). 

Examples of relocatable expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. 
LIMA is relocatable in a different block. The control counters are for the block that contains 
EASY and FOX. 

LIMA+MIKE-16 
FOX-EfiSY+FOX 
3*F0X-2*FASY 
eftSY-»4-F0X 

FOX-IOOB/MIKE 
-MIKE^2fLIMA 
=10HHESSAGE 33 
-♦0 

The pairing of relocatable terms cancels the effect of relocation because both terms would be relocated 
by the same amount. The comparative value of the two terms remains the same regardless of program 
relocation. 

External Expressions 

An expression is external if its value depends upon the value of a symbol defined outside of the current 
subprogram. Either an external expression consists of a single positive external term or under the 
following conditions an external expression may consist of an external term, relocatable terms, and 
absolute terms. 
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1. The expression contains an even number of relocatable terms. 



2. The relocatable elements must cancel each other. That is, each relocatable element ( or 
multiple thereof) in a block must be canceled by another element (or multiple thereof) in the 
same block. In other words, pairs of elements in the same block must have signs that oppose 
each other. The elements that form a pair need not be contiguous in the expression. 

Examples of external expressions: 

In the following examples, XYZ and ABC are external symbols. EASY and FOX are in the same 
block. The control counters are for the block that contains LIMA. MIKE is absolute. 

• ''■i-FPX-CftSY+LIMA The pairs * and LIMA, and FOX and EASY cancel each other. 

Fr)x-3«^fflSYv2*F0X<-XY7 The relocatable elements all cancel. 

ARC* 10 OB ♦MIKE MIKE and lOOB are absolute; no relocatable elements. 

X y Z + ARC Illegal; both are external. 

_flor^.»_{_ Yf*fl Illegal; ABC is negative. 

Xf /f^O Illegal; *0 is an unpaired relocatable element. 

Register Expressions 

An expression is a register expression if, in a CPU assembly, it reduces to one or more register 
designators and an operand. The attributes of the operand can be that of an absolute, external, or 
relocatable expression. Use of register expressions is generally restricted to symbolic CPU machine 
instructions (Sections 8.4 and 8.5). If the register designator is the first element in the expression, 
the operator can be omitted and is assumed to be +. 

Examples of register expressions: 

In the following examples, XYZ is an external symbol and LIMA is a relocatable symbol. 

X3+LIMA-10P 

LlMn+X3-inn > Produce identical results 

BlfXY7 

Evaluatable Expressions 

An evaluatable expression is an expression that does not contain any symbols as yet undefined. Certain 
pseudo instructions require that the expressions be evaluatableo 
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2.8.2 EVALUATION OF EXPRESSIONS 



\Mien evaluating an expression, COMPASS replaces each element with a 60-bit value. A character 
constant is first right or left adjusted in a field the size of the destination field and then extended to 
60 bits. Signs are extended for 21-bit quantities, that is, for counters, addresses, and symbols. In 
division, the integral portion of the quotient is retained; any remainder is discarded. Thus, 5/2*2 
results in 4. 

COMPASS forms a term value by interpreting each element and operator from left to right until it 
reaches a + or - or a operator. It then notes whether or not the newly formed term contains a 
relocatable or external symbol or register designators. The value of the symbol is added, subtracted, 
or differenced from the cumulative sum of the absolute elements, relocatable elements, or external 
values. The assembler continues evaluating the expression until it is reduced to a sjmibol and/or a 
value. An error is flagged if the expression cannot be reduced. The expression value is truncated, if 
necessary, and placed in the destination field. If it is too large for the field, the system issues an 
error flag. The maximum field size for an expression is 60 bits. 

The value of an external symbol is zero if the external symbol is defined outside of the subprogram. 
It is the value relative to the external used in defining the symbol if the external symbol Vvas defined 
within the subprogram. 

A zero value is used in place of a register designator. 

For pass one evaluation, COMPASS uses the value of a relocatable symbol relative to the block in which 
the symbol vvas defined. For pass two evaluation, COMPASS uses a value relative to program or common 
block origin. 

The field size for an expression depends upon the instruction and is determined as follows: 

© For a symbol definition pseudo instruction, the expression value (including character 
constants) is justified in a 21 -bit field. 

• In a VFD pseudo instruction, the expression is placed in a field of the size specified. 

© For a CON pseudo instruction, the field size is one word (12 bits for PPU assemblies, 
60 bits for CPU assemblies). 

© In a symbolic machine instruction, values of expressions are placed in address fields (18 or 
6 bits for CPU assemblies; 18, 12, or 6 bits for PPU assemblies). 

Some relocatable program loaders may give unexpected results if relocatable or external address values 
are assembled into the same field of the same word more than once, as a result of ORGing baclavard 
over the word, or by having more than one subprogram preset a common block. The ORGC pseudo 
instruction (see section 4. 5. 3) can be used to avoid such problems. 
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This chapter is designed to give the programmer a better understanding of how a program is assembled, 
loaded, and executed. This discussion of program structure is at the machine executable level, the level at 
which code is loaded into memory and executed. 

A COMPASS subprogram consists of statements beginning with an IDENT pseudo instruction ajid ending 
with an END pseudo instruction. The user can designate a subprogram to be a main program by specifying 
a transfer address in its END pseudo instruction. 

The programmer can control the assembly of COMPASS source statements so that subprograms are divided 
into blocks of binary code. These blocks can be controlled during the loading process. The first section of 
the chapter presents subprogram block concepts and how the programmer and the assembler organize 
object code into blocks. Following this is a brief description of the counters used to control the blocks. 

A subprogram loaded into central memory can be either absolute or relocatable. An absolute subprogram is 
loaded at the same fixed address every time; a relocatable subprogram can be loaded into different 
locations, according to the available central memory at load time. Sections 3.3 and 3.4 discuss the 
structure of absolute and relocatable programs, respectively, and show the differences in block usage for 
both types. 

Limited available central memory occasionally requires the use of overlays and partial binary sections in 
lengthy programs. Section 3.4 covers the use of these important programming tools. 



3.1 SUBPROGRAM BLOCKS 

A sii3program, whether assembled as absolute or relocatable, can" be divided into subprogram areas called 
blocks. As assembly of a subprogram proceeds, the assembler or the programmer designates that object 
code be generated or that storage be reserved in specific blocks. By properly assigning code sequences, 
data, or reserved storage areas to blocks through use of ORG or ORGC, USE or USELCM, a programmer 
can intersperse instructions for the different blocks. The assembler assigns locations in a block 
consecutively as it encounters instructions destined for the block. A symbol defined within a block is not 
local to the block. That is, it is global and can be referred to from any other block in the subprogram. To 
render a symbol local to a sequence of code requires use of the QUAL pseudo instruction (section 4.4.3). 

Blocks established between two IDENT instructions, or between an IDENT and END, form a group of 
blocks. COMPASS recognizes a maximum of 255 blocks in a single block group, 252 of which can be 
user-established. When COMPASS interprets an IDENT or END pseudo instruction, it begins pass two 
processing of the completed block group. 

In pass two all symbols are assigned absolute values, the table of block names is cleared, the list of USE, 
USELCM, ORG, and ORGC instructions is cleared, and block structuring restarts. For END, the symbol 
table is cleared before the next subprogram is assembled. If the group does not contain a USE instruction 
or if object code is generated (or storage reserved) before the first USE instruction, COMPASS places the 
code in the nominal block (identified as PROGRAM* on the listing). For an absolute program, the nominal 
block is the absolute block. For a relocatable program, the nominal block is the zero block. The user 
controls use of the nominal block and any user-established blocks through USE, USELCM, ORG, and ORGC 
pseudo instructions (section 4.5). Each occurrence of a non-redundant literal constant causes an entry in 
the literals block; otherwise, the user has no control of this block. 
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3.1.1 ABSOLUTE BLOCK 



The absolute block is the nominal block for an absolute assembly. It is identified by the name PROGRAM* 
on the listing. All code generated in the block is absolute. Each address symbol is defined during pass one 
as an absolute value relative to zero which is block origin. The code generated must be loaded and 
executed at the origin specified as the absolute block origin. 

Normally, a relocatable assembly does not contain an absolute block. It may have one established, 
however, if the programmer issues an ORG (or ORGC) request using an absolute value. The assembler 
generates text tables specifying absolute block relocation. The loader loads the absolute text when it 
encounters the text table, without manipulating any addresses. For a relocatable assembly, an absolute 
block is identified on the assembly listing by the name ABSOLUTE*. There is no ECS/LCM absolute block. 



3.1.2 ZERO BLOCK 

The zero block has the block name and is the nominal CM/SCM block for a relocatable assembly. It is a 
local block; that is, it is not accessible to other subprograms. Upon completion of assembly, the assembler 
assigns any undefined default symbols at the end of the zero block. The zero block is identified by the 
name PROGRAM* on the assembler listing. 

An absolute program has a zero block only if the program contains default symbols. In an absolute 
assembly, the zero block immediately follows the absolute PROGRAM* block. The zero block is also 
named PROGRAM*. 

There is no ECS/LCM zero block. 



3.1.3 LITERALS BLOCK 

COMPASS generates literal data entries in the literals block. It is local to a subprogram. The literals 
block is identified by the name LITERALS* on the assembly listing. COMPASS always assigns storage to 
the literals block immediately following the zero block. There is no ECS/LCM literals block. 



3.1.4 USER-ESTABLISHED LOCAL BLOCKS 

By using USE and USELCM statements, a programmer can establish local blocks in addition to those 
previously described for an absolute or relocatable subprogram. At the end of assembly, COMPASS assigns 
an origin relative to the nominal block to each user-established local block, in the sequence in which they 
are established. 

All of the CM/SCM local blocks are concatenated to form a single block, which is treated by the loader as 
a CM/SCM block whose name is unique to the subprogram. Similarly, all of the ECS/LCM local blocks are 
concatenated to form a single block which is treated by the loader as an ECS/LCM block whose name is 
unique to the subprogram. (SCOPE 2 does not currently allow LCM local blocks.) 

The length of each ECS/LCM block, including the combined local block, is rounded up, if necessary, to an 
integral multiple of eight 60-bit words. The maximum size of an ECS/LCM block is 1,048,568 words. 



3.1.5 LABELED COMMON BLOCKS 

A labeled common block is a storage area that can be preset with data accessible to one or more 
relocatable subprograms. These blocks are designated during assembly as being in CM/SCM or ECS/LCM 
through the USE and USELCM pseudo instructions respectively, where the name of the block is the name 
enclosed by slashes; that is, /name/. The tables are designed so that the loader can allocate space in 
memory for the first subprogram that is loaded that declares the block. Thus, the first subprogram that 
names a block sets the maximum size of the block. Each subprogram, as it is loaded, can link to allocated 
blocks or can cause new blocks to be allocated. The contents of a labeled common block can be generated 
by any of the subprograms having access to it. 
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If an absolute subprogram attempts to establish a labeled common block by using a USE /name/ or USELGM 
/name/ pseudo instruction, COMPASS treats the block as a local block having the slash-enclosed name. 



3.1.6 BLANK COMMON BLOCKS 

A blank common block is a storage area that cannot be preset with data. That is, the loader does not load 
information into the area before the program is executed. 

For a relocatable program, the CM/SCM and ECS/LCM blank common blocks are allocated space by the 
loader after all subprograms are loaded, according to the largest block area declared by any of the 
subprograms. A CM/SCM blank common block is established tlirough use of the USE pseudo instruction 
(section 4.5.1). An ECS/LCM blank common block is established through use of the USELCM pseudo 
instruction (section 4.5.2). A blank common block has no name, A USE // indicates blank common in 
CM/SCM; A USELCM // indicates blank common in ECS/LCM. 

If no relocatable program declares a blank common block, there is none. If an absolute program contains a 
USE // or USELCM // pseudo instruction, COMPASS treats the block as a local block named // and data can 
be stored in this block. 

The USELCM pseudo instruction can occur only in CPU programs. 



3.1.7 REDUNDANT BLOCK NAMES 

A CPU subprogram may have two blocks with the same name and the same memory type if they have 
different block types (local or common). Furthermore, a CPU subprogram may have two blocks with the 
same name and the same block type if they have different memory types (CM/SCM or ECS/LCM). Thus, 
altogether, there may be up to four different blocks with the same name. 



3.2 BLOCK CONTROL COUNTERS 

For each block used in a subprogram, COMPASS maintains three counters: an origin counter, a location 
counter, and a position counter. When a block is first established or its use is resumed, COMPASS uses the 
counters for that block. During pass one, the origin and location counters are initially zero. During pass 
two, as the assembler constructs tfie program, it assigns an initial value to each local block origin counter 
and location counter. Thus, expressions containing relocatable symbols are not necessarily evaluated the 
same in pass one and pass two. 



3.2.1 ORIGIN COUNTER 

The origin counter controls the relative location of the next word to be assembled or reserved in the block. 
It is possible to reserve blank storage areas simply by using either the ORG, ORGC, or BSS pseudo 
iastructions to advance the origin counter; ORG and ORGC also permit the programmer to reset the 
counter to some lower location in the block or to change blocks. BSS allows the programmer to decrement 
the counter but not to change blocks. The origin counter is incremented by one for each word assembled or 
skipped forward. The origin counter is decremented by one for each word skipped in the reverse direction. 

When the special element *0 is used in an expression, the assembler replaces it by the current value of the 
origin counter for the block in use. 
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3.2.2 LOCATION COUNTER 



The location counter is normally the same value as the origin counter and is used by the assembler for 
defining symbolic addresses within the block. The counter is incremented whenever the origin counter is 
incremented. It is possible through the LOG pseudo instruction to adjust the location counter so that it 
differs from the origin counter. This may be desirable when the code being assemoled is to be loaded at 
one location and subsequently moved and executed at another location. In this case, the programmer resets 
the location counter to reflect the actual location at v/hich execution is to occur. As another example of 
its use, the programmer assembling a large table may reset the location counter to zero so that on the 
listing, the addresses alongside each word of the table reflect the word's position in the table rather than in 
the block. Note that use of this technique does not alter the placement of code in the block. (For an 
example of these applications, see the LOG pseudo instruction, section 4.5.5.) When either of the special 
elements * or *L is used in an expression, the assembler replaces it by the current value of the location 
counter for the block in use. 



3.2.3 POSITION COUNTER 

Assume that bits are numbered 59 through 00, from left to right within a 60-bit CPU word and numbered 11 
through 00 within a 12-bit PPU word. Then, the position counter is initially 60 or 12, respectively, and 
indicates the number of bits remaining in the word. The position counter, which is decremented by one for 
each completed bit of an assembled word, becomes 00 when the word is completed, and is reset to 60 or 12 
when a new operation is started. 

For a CPU assembly, the 15-bit and 30-bit GPU instructions cause the position counter to normally have 
values of 60, 45, 30, and 15 reflecting the placement in the word for the next instruction or data value to 
be generated. For a PPU assembly, the normal value is 12. 

The normal pattern of advancement for the position counter can be altered through use of the VFD and 
POS pseudo instructions. 

When the special element *P is used in an expression, the assembler replaces it with the current value of 
the position counter. 

When the special element $ is used in an expression, the assembler replaces it with the current value minus 
one of the position counter for the block in use; that is, it returns the next available bit position. 



3.2.4 FORCING UPPER 

In a CPU assembly, if any of the foUowing conditions is true, the assembler packs parcels remaining in a 
partially completed word with no-operation instructions (section 8.1), sets the position counter to 60, and 
increments the origin and location counters before it assembles code for the next instruction: 

• Insufficient room remains in a partially filled word for the next instruction or data to be generated. 

• The current statement is a machine instruction, or a VFD pseudo instruction, with a location symbol 
or + in the location field. 

• The current statement is an RE, WE, PS, XJ, CC, CU, DM, or IM instruction for a CYBER 170 Series 
or CYBER 70/Model 71, 72, 73, 74, or 6000 Series. (The programmer can negate this force upper by 
placing a minus sign in the location field of the instruction.) 

• statement is an END, BSS, BSSZ, DATA, DIS, CON, SEGMENT, SEG, IDENT, ORGC, LOG, 
ORG, or MD pseudo instruction. 
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The assembler forces upper after it assembles code for one of the following: 

JP 
RJ 

Unconditional EQ 
Unconditional ZR 
ES (CYBER 70 Model 76 or 7600) 
MJ (CYBER 70 Model 76 or 7600) 

PS (CYBER 170 Series, CYBER 70 Model 71, 72, 73, 74, or 5000 Series) 
XJ (CYBER 170 Series, CYBER 70 Model 71, 72, 73, 74, or 6000 Series) 
IM (CYBER 70 Model 72 and 73) 

This post force upper does not occur immediately, but is deferred until the assembler encounters the next 
machine instruction or data generating, storage allocating, or binary control pseudo instruction in the same 
USE block. The programmer can negate the force upper following the instruction by placing a minus sign in 
the location field of the next instruction. Thus, pseudo instructions following one of the above machine 
instructions and referencing the origin, location, or position counter will use the value before the force 
upper. 

In a PPU assembly, no forcing upper occurs; the assembler ignores a + in the location field on any 
instruction other than a VFD. A plus or minus in the location field of a VFD in PPU assemblies forces the 
VFD data to begin at the next full word. 



3.3 RELOCATABLE PROGRAM STRUCTURE 

A CPU relocatable program consists of one or more subprograms that can be assembled separately, either 
in the same job run or in independent runs. The subprograms can all be written in COMPASS source 
language, or can be written in any other source language available in the product set of the operating 
system as long as the compiler or assembler produces relocatable binary output in a form acceptable to the 
loader. A COMPASS language subprogram is composed of instructions beginning with an IDENT pseudo 
instruction and ending with an END pseudo instruction. A subprogram can be either a main program or a 
subroutine, depending on how its END pseudo instruction has been written. 

When a program is loaded into memory, its subprograms occupy contiguous blocks of words. The first word 
in the first block is known as the reference address (RA). The total number of words in the blocks is the 
job field length. 

When a subprogram is relocated, each machine instruction in it that references a specific address must oe 
adjusted. Because of this necessity, relocatable subprograms are assembled as though they begin at address 
zero; they are not assigned specific origins. In this way the loader can load subprograms independently, yet 
contiguously; their origins are relative to RA. Since all addresses within the subprogram are relative to the 
first word address of the subprogram, each address in the program effectively becomes a function of RA. 

A nonblank IDENT pseudo instruction that does not specify a fixed load address indicates a relocatable 
subprogram. Upon completing assembly of a relocatable subprogram, COMPASS assigns each local block an 
origin relative to the zero block. Each block thus becomes an extension of the zero block (figure 3-i). 

COMPASS also provides for subprogram linkage. Through pseudo instructions such as ENTRY, ENTRYC, 
and EXT, subprograms can transfer control to each other and access common storage locations. 

The loader is thus able to load subprogram blocks independently, as required. Program execution is not 
affected by the relocation process. 

The length of the subprogram given on the assembly listing is the sum of the final values of the origin 
counters for the local blocks, including the zero block and literals block, but not the absolute block. Any 
absolute text is simply inserted at the absolute location relative to RA. 

COMPASS binary output for a relocatable subprogram consists of one section for each LCC pseudo 
instruction (if any) in the source program, followed by one section containing the subprogram loader tables. 
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Figure 3-1. Relocatable Program Structure 



3.4 ABSOLUTE PROGRAM STRUCTURE 

An absolute program consists of code that is not relocatable and must be loaded at specific memory 
locations. Because the loader performs no address manipulation for absolute programs, absolute code can 
be loaded more rapidly than relocatable code. 

A CPU program can be either relocatable or absolute. PPU programs are always absolute. PPU programs 
are parts of the operating system that reside in the peripheral processors; they are normally the concern of 
only system analysts. Any user can assemble PPU code, but cannot execute it without special system 
access privilege. 

The programmer has the option of constructing an absolute program as a single unit, or of dividing it into 
overlays. Each overlay consists of data, information, or instructions that are needed at different times. 
Dividing a program into overlays allows several routines to occupy the same central memory storage 
consecutively so that total storage requirements for a program are reduced. For maximum program 
efficiency, the reduction of storage requirements must be weighed against an increase in execution delay 
while loading parts of the program. 

During assembly of an absolute program or overlay, COMPASS creates a memory image of the absolute 
code. During pass two, it assigns each block an origin relative to the absolute olock. Any relocatable 
symbol is reassigned an absolute address; each block effectively becomes an extension of the absolute block. - 

Figure 3-2 illustrates the structure of an absolute program that is not divided into overlays. The absolute 
block is the nominal block for the program (labeled PROGRAM* on the listing). The use of default symbols 
and literals causes the generation of the zero block and the literals block, respectively. Local blocks A, B, 
and C follow the literals block. The transfer symbol in the END pseudo instruction indicates a main 
subprogram. In the binary load module the'prefix (PRFX or TTOOg) table and the header table precede 
I the binary section that is the memory image of the program. 
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Figure 3-2. Absolute Program Structure 
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The binary output for the program consists of a section for each overlay. Note that the binary section for 
an absolute program that is not divided into overlays has the same format as the main overlay of a program 
divided into overlays. The user has the option of writing part of a binary section at a time by using either a 
SEG pseudo instruction or an IDENT (other than the first IDENT) with a blank variable field. 

An absolute binary load module usually has three parts: a prefix (PRFX or TTOOg) table, a header table, 
and the binary image of the program or overlay. A header table can be one of the following: 

• ASCM or 50003. 

• EASCM or SlOOg. 

• ACPM or oSOOg. 

• EACPM or 54003. 

Tables are shown on a COMPASS listing by their octal numbers. The table formats are described in the 
Loader reference manual. 

The amount of binary written as a result of the binary control instruction (IDENT, SEGMENT, SET, or END) 
is subject to whether or not an entire block group is written, as follows: 

« If a complete block group is being written (everything between an IDENT and an END or between two 
IDENT instructions), the memory image of the program or overlay ends with the maximum origin 
counter value for the last block established, that is, with the last word address. 

• If only a portion of the binary for the block group is being written, it consists of the memory image of 
the program or overlay ending with the value of the current origin counter. 

END, SEGMENT, and a nonblank IDENT complete one overlay and write an end of section. SEGMENT and 
IDENT write header information for the overlay to follow. 



3.4.1 ABSOLUTE OVERLAYS ^ 

When an absolute program contains more than the one IDENT^ pseudo instruction or contains SEGMENT 
pseudo instructions, COMPASS does not prepare just one section of a memory image of the program as it is 
assembled, but, instead, generates a section for each overlay. 

Dividing the program into overlays permits memory to be sequentially overlaid by different subroutines and 
data during program execution, reducing the maximum memory requirements for the program. 

Three levels of overlays can be generated for a CPU assembly: main, primary, and secondary. Each 
overlay is identified by a level number specified in the IDENT or SEGMENT pseudo instruction. The level 
number consists of an ordered pair of octal numbers, each of which can be tlirough TTg. The first 
number is known as the primary level number; the second is known as the secondary level number. The 
level number 0,0 signifies the main overlay (normally the portion of the program following the first 
IDENT). A primary overlay is indicated by a nonzero primary number paired with a zero secondary level 
number. For a secondary overlay both the primary and the secondary level numbers are nonzero. 

Conventionally, the main overlay is loaded first and remains in central memory throughout execution. Only 
two other overlays can remain loaded concurrently: these are usually one primary overlay and one of its 
associated secondary overlays. 



■^IDENT instructions described in this section are assumed to have nonblank parameters. The special case 
of the blank IDENT is described in section 3.4.3. 
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The hierarchy of overlay association is depicted by fi^re 3-3. The primary overlay 1,0 has three 
associated secondary overlays numbered 1,1; 1,2; and 1,3. A primary overlay and ail of its associated 
secondaries have the same primary level number. The next branch of overlays (indicated by level 
numbers 77,y) shows that the level num.bers of the overlays are not required to be consecutive nor to be 
indicative of the order in which they were generated. 




Secondary 
Overlays 



Primary 
Overlays 



Main 
Overlay 



Figure 3-3. Overlay Hierarchy 



The main overlay can call both primary and secondary overlays into main memory via the operating system 
loader. (For detailed information concerning loader calls, see tfie Loader reference manual.) Once a 
primary overlay is loaded, it can call any of its associated secondary overlays. Overlay 23,0, for example 
can call overlays 23,10; 23,30; and 23,40 in any order. 

The main overlay can have multiple entry points: execution can begin at any one of them. Usually, 
primary and secondary overlays have a single entry point which provides the transfer address. A secondary 
overlay can reference entry points in its primary and in the main overlay. A primary overlay can reference 
entry points in the main overlay. The programmer must ensure that the necessary entry points have not 
been overwritten. 



These conventions concerning the numbering, hierarchy, loading, and execution of overlays are not 
enforced by COMPASS. Any overlay can call the operating system loader to load another overlay, and any 
overlay can reference addresses in any other overlay. However, overlays are not all in central memory 
during program execution and the sequence in which the overlays are loaded and executed is beyond the 
scope of the assembler; therefore, it is the user's responsibility to assure that an overlay does not refer to 
symbols, instructions, or data not concurrently in central memory. 

Although PPU overlays are not identified by level numbers, they resemble CPU overlays in all other 
respects. However, a PPU overlay with assembled code in locations 77748 through 7777q may load 
incorrectly due to wraparound to location 0000. 

Overlays generated by using IDENT pseudo instructions differ in certain respects from overlays generated 
by using SEGMENT instructions, as described below. 

Binary formats for overlays are described in the Loader reference manual. 
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IDENT-Type Overlays 

An IDENT-type overlay consists of the portions of the program from: 
« One IDENT to (but not including) the next IDENT 
• The last IDENT in the overlay to the END 

IDENT provides the programmer with the option of specifying the overlay level numbers with each 
overlay. The assignment of unique level numbers enables the loader to locate a specified overlay among 
overlays written on the same file. If the programmer does not specify level numbers for a CPU assembly, 
COMPASS assigns numbers 0,0 to the first overlay, and numbers 1,0 to all subsequent overlays. 

The first IDENT causes COMPASS to generate the program or overlay identification information that 
precedes the absolute section. Upon encountering a second IDENT instruction before an END instruction, 
COMPASS generates output consisting of a memory image of the overlay, starting with the overlay origin 
specified on the previous IDENT and normally ending with the maximum origin counter value of the last 
block declared in the overlay; that is, the overlay normally ends with the last word address of its last 
block. An IDENT subsequent to a SEG or SEGMENT, however, generates binary that ends at the location 
specified by the current origin counter. Following the memory image, COMPASS writes an end-of-section 
(or end-of-record) and the overlay identification information specified by the new IDENT for the overlay to 
follow. 

For an IDENT-type overlay, COMPASS completes all blocks, including the literals block. Block structuring 
starts fresh with each overlay. This means that each ovei'lay can use the same block names used by other 
overlays, and each overlay can contain a literals block. The USE table and control counters are all 
reinitialized. The origin specified for an IDENT-type overlay can be any place in a previously generated 
overlay. This is possible because IDENT causes the assembler to assign an absolute address to each symbol 
in the symbol table. It can do this because the sizes of all the blocks are known. 

Figure 3-4 illustrates a CPU program in which a second IDENT is used prior to an END pseudo instruction 
to generate a main overlay and a primary overlay. Between the tv/o IDENT instructions, block usage 
alternates between the absolute block (labeled PROGRAM* on the listing) and block A, as depicted in the 
block structure diagram. Note that in the main overlay (the first section of binary generated, labeled 
MAIN), the assembler has concatenated the portions of each block. Concatenation also occurs in the 
primary overlay, OVl, for the portions of the absolute block ABSOLUTE' and for those of blocks A', B, 
and C. 

The occurrence of literals and default symbols causes the assembler to generate a zero block and a literals 
block, respectively, in both of these overlays. Following the second nonblank IDENT, the program overlay 
origin is set back into block A, as shown in the map of the two loaded overlays. Note that the loader 
control table is loaded in memory below the address specified in the ORG pseudo instruction (BETA, in the 
figure), as shown in the map of the loaded overlays. 

The first IDENT pseudo instruction assigns the level number 0,0 to the first overlay (MAIN). COMPASS 
assigns level number 1,0 to overlay OVl by default. 



SEGMENT-Type Overlays 

A SEGMENT-type overlay consists of the portions of a program from: 

• The IDENT that identifies the program to a SEGMENT pseudo instruction 

• One SEGMENT to the next SEGMENT 

• The last SEGMENT to the END pseudo instruction 
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Figure 3-4. IDENT-Type Overlay Structure 
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SEGMENT provides the programmer with the option of specifying the overlay level numbers with each 
overlay. The assignment of unique level numbers enables the loader to locate a specified overlay among 
overlays written on the same file. If the programmer does not specify level numbers for a CPU assembly, 
COMPASS assigns numbers 0,0 to the first overlay, and numbers 1,0 to all subsequent overlays. 

Upon encountering a SEGMENT instruction, COMPASS generates output consisting of a memory image of 
the overlay starting with the overlay origin specified on the previous SEGMENT (or IDENT, for the first 
overlay), and ending with the current origin counter value of the block in use at the time the SEGMENT 
was encountered. Following this, COMPASS writes an end-of-section and overlay identification 
information for the overlay to follow. 

SEGMENT does not clear the symbol table or reinitialize the USE table. Thus, when a SEGMENT is 
encountered, the block in use is incomplete. It is the responsibility of the user to assure that all blocks 
other than the one in use are complete at that time. Also, the only symbols that can be used to define the 
origin of the new overlay are those valid for the block in use. 

Each new SEGMENT-created overlay must use unique block names because blocks established in previous 
overlays cannot be resumed and because the block names remain in the USE table due to the 
incompleteness of the block group. 

Figure 3-5 illustrates a program consisting of a main overlay, MAIN, and a primary, OVl. The use of 
default symbols causes generation of a zero block. The use of literals causes generation of a literals 
block. Both of these blocks occur in the overlay MAIN, because it contains the end of the absolute block. 
Block A begins in the main overlay, but is incomplete when COMPASS encounters the SEGMENT. The 
ORG pseudo instruction causes the origin of the primary overlay OVl, to be set at load time to TAG, at a 
lower address in block A. (Note that the loader control information is loaded at an address lower than the 
origin of the overlay.) OVl establishes new blocks C and D. 



3.4.2 MULTIPLE ENTRY POINT OVERLAYS 

When a CPU program or overlay that calls an overlay is assembled independently of the overlay called, it 
may be desirable for the called overlay to identify more than one entry point. Thus, ENTRY pseudo 
instructions are permitted within an ateolute assembly and cause the generation of a SlOOg overlay 
table. This table consists of a control word and a list of overlay entry points. The calling program can 
examine the list and link to any of the entry points. The 5100g table occupies the area below the overlay 
origin and uses one more word than the number of entries in the table. For the format of the SlOOg 
table, refer to the Loader reference manual. 



3.4.3 PARTIAL BINARY 

When a CPU absolute program or overlay contains SEG pseudo instructions or IDENT pseudo instructions for 
which the parameters are omitted (blank), COMPASS writes a partial binary section consisting of the 
binary generated since the previous IDENT, SEGMENT, or SEG instruction. However, it does not write an 
end-of-section (or end-of-record) or a new prefix table. A SEGMENT, nonblank IDENT, or END instruction 
completes the binary section. 

SEG Partial Binary Record 

By writing partial binary records using SEG, the programmer can reduce the assembler storage 
requirements. SEG does not write a complete block group. When the SEG is encountered, COMPASS writes 
binary beginning with the first block established in that portion of binary and ending with the final count 
specified by the origin count for the current block. A fatal error is issued if the user attempts to store 
data into a block not in the current partial binary record. 

The portion of the binary that contains the end of the absolute block contains the literals block, if there is 
one. The symbol table and USE table are not reinitialized. 
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Figure 3-5. SEG]\IENT-Type Overlay Structure 
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Figure 3-6 illustrates how the binary for an absolute program can be written in three separate binai-y 
writes to reduce the amount of memory required to assemble the program. The resulting absolute section 
IS loaded and executed as a single program or overlay. 



IDE NT PROG- 



SEG 
(writes partial- 
binary) 

SEG 
(writes partial- 
binarv) 



ABSOLUTE 



END- 



ABSOLUTE 



Largest partial assembly 
determines assembler 
storage requirements 



Source Program 
Block Structure 



S Prefix Table::;: 



^Loader Control: 
iKlnformation^K 



\ 



ABSOLUTE 



LITERALS 



Absolute Binary 
Section 



End-of-scction 



Binary Load 
Module 



Figure 3-6. SEG Partial Binary 

IDENT Partial Binary 

^JJIS^^Z ^^^u ^ ^^^^ variable field causes all binary accumulated since the previous IDENT, SEG, or 
bhGMLNT to be written out without an end-of-section (or end-of-record) or a new TTOOq prefix table. 
The USE table and the block counters are reinitialized. Each symbol in the symbol table is assigned an 
absolute address. The blocks in each partial binary section generated in this manner are allocated as if the 
partial binary section were a new subprogram with its own absolute block, literals block, and local blocks. 
Ihis allows portions of a program to be self-contained units even though they are not overlays but are 
loaded as a single unit. The origin of an absolute block for new portion is the last word address plus one of 
the last block of the previous portion. 

The core image written by a blank IDENT starts with the origin of the absolute block and normally ends 
with the maximum origin counter value of the last block declared in the block grouo; that is, it normally 
ends with the last word address. If part of the block group has already been written by a SEG or 
SEGMENT, however, the end of the binary is specified by the value of the origin counter for the current 
block. 

m^TTM^^^I completes all blocks. The literals block is terminated. Block structuring starts fresh with each 
i^J* I P^^^^^^ ^^^^^ section created by a blank IDENT can use the same block names as are 

V. S^^Tt°^^^' ^^^^ IDENT-created partial binary sections and non-blank IDENT-created overlays and 

each IDENT can contain a literals block but the blocks with the same names are independent of each other. 

An attempt to write into or to reset the origin counter to a location in a partial binary section written 
separately causes an assembler range error. 
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Figure 3-7 illustrates how the binary for an overlay can be written in three discrete partial binary sections 
to reduce the amount of central memory required to assemble the program and divide the program into 
self-contained units. The resulting absolute section is loaded and executed as a single overlay. 
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Figure 3-7. IDENT Partial Binary Records 
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PSEUDO INSTRUCTIONS 



4 



4.1 INTRODUCTfOM TO PSEUDO INSTRUCTIONS 

The format of the COMPASS pseudo instruction is the same as that of the symbolic machine instruction; it 
includes the location field, the operation field, the variable field, and the comments field. The pseudo 
instruction differs from the symbolic machine instruction in that it is used to control the actions of the 
assembler at assembly time, rather than those of tlie machine at execution time. 

The pseudo instructions available in the COMPASS language are presented in this chapter and in 
chapters 5, 6, and 7. Programmers with little COMPASS experience should give special attention to a few 
important pseudo instructions, which are listed in the following table. It is not possible to write a 
COMPASS program Vv'ithout using some of them. The table indicates the type of assemblies in which the 
pseudo instructions can be used. 



Pseudo Instruction 


Section 


CPU Relocatable 


CPU Absolute 


PPU Absolute 


IDENT 


4. 2.1 




X 


X 


X 


ABS 


4. 3.1 






X 




PPU or PERIPH 


4.3.3 or 


4.3.4 






X 


ORG 


4.5.3 




X 


X 


X 


ENTRY 


4.7.1 




X 






BSS 


4.5.4 




X 


X 


X 


CON 


4.8.6 




X 


X 


X 


END 


4. 2.2 




X 


X 


X 



4.1.1 TYPES OF PSEUDO INSTRUCTIONS 

Pseudo instructions discussed in this chapter are classed according to application as follows: 
» Subprogram identification (IDENT and END) 

e Binary control (ABS, MACHINE, PERIPH, PPU, IDENT, SEGMENT, SEG, LCC, LDSET, STEXT, 
COMMENT, and NOLABEL) 

• Mode control (BASE, CHAR, CODE, COL, Bl=l, B7=l, and QUAL) 

« Block counter control (USE, USELCM, ORG, ORGC, BSS, LOG, and POS) 

o Symbol definition (EQU and =, SET, MAX, MIN, MICCNT, and SST) 

e Subprogram linkage (ENTRY, ENTRYC, and EXT) 

• Data generation (BSSZ and blank operation code, DATA, DIS, LIT, VFD, CON, R=, REP, REPC, and 
REPI) 

© Assembly control (ELSE, ENDIF, IFtype, IFop, IF, IFC, IFPL, IFMI, and SKIP) 

• Error control (ERR and ERRxx) 

• Listing control (LIST, EJECT, SPACE, TITLE, TTL, NOREF, CTEXT, ENDX, and XREF) 
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Later chapters describe pseudo instructions that involve definition operations, alterations to the operation 
code table, and micros. In general, pseudo instructions can be summarized according to where they can be 
placed in a subprogram. 



4.1.2 REQUIRED PSEUDO INSTRUCTIONS 

Two pseudo instructions, IDENT and END, are required for any assembly. IDENT must be the first source 
statement; END signals the termination of source statements for a subprogram. 



4.1.3 FIRST STATEMENT GROUP 

Certain pseudo instructions establish basic characteristics of the assembly and provide the assembler with 
required information. These instructions make up the first statement group which must precede any 
symbol definition, storage allocation, or object code generation. The following instructions, if used, must 
be in the first statement group: 

ABS 

MACHINE 
PERIPH 
PPU 
STEXT 



4.1.4 PERMISSIBLE ANYWHERE INSTRUCTIONS 



The follovdng pseudo instructions are permissible anywhere, including in the first statement group: 



BASE 

Bl=l 

B7=l 

CHAR 

CODE 

COMMENT 

CPOP 



CPSYN 

DECMIC 

EJECT 

ELSE 

END 

ENDD 

ENDIF 



EN DM 

HERE 

IFC 

IRP 

LDSET 

LIST 

MACRO 



MACROE 
MICCNT 
MICRO 
NIL 

NOLABEL 
NOREF 
OCT MIC 



OPDEF 

OPSYN 

PPOP 

PURGDEF 

PUR G MAC 

QUAE 

RMT 



SKIP 

SPACE 

SST 

TITLE 

TTL 

XREF 



Comment lines and references to macro definitions are also permitted anywhere. 

CPU or PPU symbolic machine instructions and all other pseudo instructions cannot be placed in the first 
statement group. The first use of one of these instructions terminates the first statement group. 



4.2 SUBPROGRAM IDENTiFiCATiON 

Subprogram identification pseudo instructions designate subprogram beginning and end. When two or more 
subprograms are assembled in a single COMPASS run called through the COMPASS control statement, the 
end of the source decks is indicated by an end-of-section, such as a 7/8/9 card. 



4.2.1 IDENT - SUBPROGRAM IDENTIFICATION 

An IDENT pseudo instruction of the following form is the first statement of a subprogram recognized by 
the assembler. Usually, any lines preceding the first IDENT or between an END and IDENT are assumed to 
be comments. However, when COMPASS has been called by some other language processor such as 
FORTRAN, the assembler returns control to the processor when the statement following END is not 
iDENT. For a relocatable subprogram, COMPASS flags any subsequent use of IDENT before END as an 
error. For an absolute subprogram, a second form of IDENT described under BINARY CONTROL is 
available for overlay generation. 
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The format of IDENT varies according to the type of assembly. 
CPU Relocatable Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name 



CPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name, origin, entry, , ^ ^ 



7600 PPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name , origin, entry, ppu 



6000 Series PPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name , origin 



name Name of the subprogram or overlay. The parameter is required. For a CPU relocatable 

or absolute assembly, name can be 1 through 7 characters, of which the first must be 
alphabetic (A through Z) and the last must not be a colon. 

For a CYBER 70/Model 76 or 7600 PPU assembly, name can be 1 tnrough 7 cnaracters. 
For CYBER 170 Series or CYBER 70/Model 72, 73, 74 or 6000 Series PPU assembly, 
name can be 1 through 3 characters. In either case, there is no restriction on the first 
character, but the last character must not be a colon. 

origin An expression specifying the first word address of the absolute program or overlay. The 

overlay loader table and all code assembled starting at this address and ending with the 
next SEGiMENT, nonblank IDENT, or END instruction make up the overlay. For a single 
entry point CPU program, the load address for the overlay is origin-1. The word at 
origin-1 is overlaid by the SOOOg loader control table. For a multiple entry point CPU 
program, the load address for the absolute overlay is origin-wc-1, where we is the 
number of entry points in the SlOOg loader table. 

For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words are overlaid 
by the 60-bit loader table. 

Data can be generated in locations starting with origin and above, but not below origin. 
The origin subfield does not serve the same funtion as ORG, nor does it replace ORG for 
setting the origin counter. 
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If the origin field is null for an absolute subprogram, the assembler uses address 

000000 RA(S) as the origin for a CPU program and 0000 as the origin for a PPU program. 



For a relocatable subprogram, the subfield is ignored. The loader automatically 
relocates the first subprogram to be loaded starting at RA(S)+1008, the second 
subprogram starting at the first available location following the first subprogram, and so 
forth. 

entry For a CYBER 70/Model 76 or 7600 PPU assembly or for an absolute CPU assembly, this 

subfield contains an expression specifying the subprogram entry address, which can be 
symbolic. 

ij.ig Absolute expressions specifying the level numbers of the overlay. &i is the primary 

level (0 through 63) and S.2 is the secondary level (0-63). When the first IDENT 
identifies the main overlay, and I2 can be omitted. If is omitted, it is set 
to 00. If i2 is omitted, it is set to 00. 

Because the first IDENT precedes any use of the BASE pseudo instruction, the level 
numbers on this IDENT are evaluated as decimal unless specifically designated as octal 
by a post radix. 

ppu Absolute expression specifying the number of the PPU on which this program is to be 

loaded. On the first IDENT, this number is evaluated as decimal unless specifically 
designated as octal. 

A location field symbol, if present, is ignored. 

If the COMPASS assembler is called from within a FORTRAN compilation rather than by a COMPASS 
control statement, IDENT must be in columns 11 through 15. 

When the subprogram does not include a TITLE instruction, COMPASS uses the IDENT variable field entry 
as the main subprogram title on the assembly listing. 

Example: 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 ho 




co^•TROL 


IQFNT 

ARS 

ORG 


CT , CONTROL 



, CONTROL 

lAnSOLUTE CPU PROGRAM 

joEFIiMFS SYHOtOL CONTROL 



Absolute CPU program CT will be loaded at origin address OOllOg. 



4.2.2 END - END OF SUBPROGRAM 

An END pseudo instruction must be the last instruction of each subprogram. It causes the assembler to 
terminate all counters, conditional assembly, macro generation, or code duplication. Before terminating 
assembly, COMPASS assembles any waiting remote text (see RMT). 
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For a relocatable subprogram, the assembler combines all local blocks into a relocatable subprogram 
block, generates the relocatable binary tables and produces the listing. 

For an absolute assembly, the assembler assigns each block an origin relative to absolute zero, 
combines all blocks into an absolute subprogram or overlay, generates the absolute binary section and 
produces the listing. 

END can also be used to signal the end of source statements from an external source (see XTEXT). In 
this case, it does not terminate the subprogram. 

Format: 



lOCATION 


OPERATiON 


VARIABLE SUBFIELDS 


sym 


END 


trasym 



sym Optional last word address symbol; if present, COMPASS defines it as the 

total subprogram length, including the literals block and all local blocks. 
The value is the last word address plus one. 

trasym a symbol specifying the entry point to v/hich control transfers for a reloca- 

table subprogram. This symbol must be declared as an entry point in a 
subprogram — not necessarily the subprogram being assembled. At least 
one subprogram must specify a transfer address or the loader signals an 
error. If more than one subprogram indicates a transfer address, the loader 
uses the last one encountered. 

For an absolute assembly, trasym is ignored. 

Example: 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


J 




11 


18 Uo 






IDENT 
ENTRY- 


PROGl 
BEGIN 


i 

1 






• 


• 








• 


• 






BEGIN 


• 

SBl 
• 
• 
• 

ENO 


• 

1 
• 
• 
• 

BEGIN 
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4.3 BIHAiY C0NTKOL 



Pseudo instructions that allow the user extensive control of binary output produced by the assembler 
are summarized below and described fully in this section. 

ABS Specifies CPU absolute binary output 

MACHINE Specifies processor type 

PPU Specifies CYBER 70/Model 76 or 7600 PPU binary output 

PERIPH Specifies CYBER 170 Series, CYBER 70/Model 71, 72, 73, 74, or 6000 

Series PPU binary output 

IDENT Begins absolute overlay or writes partial binary section 

SEGMENT Begins absolute overlay 

SEG Writes partial binary section 

STEXT Generates system text overlay 

COMMENT Inserts comments into the 77 prefix table 

o 

NO LABEL Suppresses header information on binary output 

LCC Passes loader control information to the relocatable loader 

LDSET Generates loader directive LDSET 

4.3.1 ABS -ABSOLUTE CPU PROGRAM 

An ABS instruction declares a CPU program to be absolute. If used, it must be in the first statement 
group. 

The following instructions are illegal in an absolute program: 

EXT 
LCC 
REP 
REPC 
RE PI 

A symbol can be prefixed by =X if it is also defined conventionally; in this case, the =X has no signifi- 
cance because a conventional definition takes precedence (Section 2.4.2). 

Format: 



lOCATION 


OPERATION 


VARIABLE SU8FIELDS 




ABS 





Symbols in the location and variable fields, if present, are ignored. If a program contains both ABS 
and PERIPH (or PPU), the PERIPH (or PPU) instruction takes precedence. 
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Example: 





tOCATION 


OPERATION 


VAi?IABl£ 


COMMENTS 


1 




n 


13 isO 






lOENT 


CT ,CONTf 








• 


• 


jABSOLUTE CPU PROGRAM 






• 

ORG 


• 

IIQR 






CONTROL 


RSS 
• 


Q 
« 


Defines syhbol control 

1 






• 

• 

END 


• 

• 


1 
1 



4.3.2 MACHINE - DECLARE OBJECT PROCESSOR TYPE 

The MACHINE pseudo instruction specifies the type of computer system on which the object program 
can be executed successfully and optionally specifies hardware features needed by tiie object program. 
If used, MACHINE must be in the first statement group. 

Format: 



LOCATION 


OPERATION 


VARiABlE SUBFiELDS 




MACHINE 


type, hf^ , hfg, hfg, . . . , hf^ 



A location field symbol, if present, is ignored. 

type Character string designating object processor type. The subfield can be any length 

and may contain any characters other than blank or comma. The first character 
identifies processor type, as follows: 

6 The object program is restricted to the following computer systems: CYBER 
170 Series, CYBER 70/Model 71, 72, 73, or 74, or 6000 Series. All machine 
Instructions unique to the CYBER 70/Model 76 or 7600 Computer Systems are 
undefined. 

7 The object program is restricted to a CYBER 70/Model 76 Computer System or 
to a 7600 Computer System. With the exception of the PS instruction (often used 
for subroutine entry points in CPU assemblies), all instructions unique to the 
following computer systems are undefined: CYBER 170 Series, CYBER 70/ 
Models 71, 72, 73, and 74, and 6000 Series. 

In a CPU assembly, if the MACHINE pseudo instruction is omitted, or the type 
subfield is blank, or its first character is not 6 or 7, then all CPU instructions 
are defined, and the target and valid fields of the PRFX table in the object pro- 
gram are blanks. If the type subfield is present and its first character is 6 or 7, 
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the valid field contains 6X or 7X. If the type subfield is at least two characters, 
the first character is 6 or 7, and the second character is a digit (0-9), the target 
field contains those two characters. 

In a PPU assembly, if the MACHINE pseudo instruction is omitted, or the type 
subfield is blanic, or its first character is not 6, or 7, then: if the PERIPH 
pseudo instruction is present, MACHINE 6 is assumed; if the PPU pseudo in- 
struction is present, MACHINE 7 is assumed. The target field of the PRFX 
table contains blanks, and the valid field contains 6P or 7P. 

hf Optional subfield, a character string designating an optional hardware feature re- 

^ quired for successful execution of the object program. The subfield may be any 

length and may contain any characters other than blank or comma. It has no effect on 
assembly of the program. The first character of the subfield is placed in the hard- 
ware-instruction-dependencies field in the PRFX table in the object prc^ram. 

Recommended mnemonic letters are: 



c 


Compare /Move Unit 


D 


Distributive Data Path 


I 


Integer Multiply Instruction 


L 


ECS/LCM 


R 


Interlock Register 


X 


Central and Monitor Exchange Jumps 



Up to nine hf. subfields are processed; any additional subfields are ignored. If the 
subfields are omitted, the comma following type can also be omitted. 

Example: 





lOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 jao 














MACHINE 


6»CMU,LCM,XJ 
• 



4.3.3 PPU . CYBER 70/MODEL 76 OR 7600 PPU PROGRAM 

A PPU instruction declares a program to be a CYBER 70/Model 76 or 7600 absolute PPU program rather 
than a CPU program. If used, PPU must be in the first statement group. For a description of binary 
format generated as a result of this instruction, refer to the Loader reference manual. 
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Floating point constants and the following instructions are illegal in a PPU assembly: 



ENTRY SEGMENT 
ENTRYC USELCM 
EXT R= 
LCC Bl=l 
REP B7=l 
REPC 
REPI 
SEG 

A symbol can be prefixed by = X if it is also defined conventionally. 

If the program contains both a PPU and a PERIPH pseudo instruction, the PPU takes precedence. 
PPU programs permit symbols of the form used for CPU register designators; they are normal symbols 
having no special significance. The following instructions are legal but are not applicable in a PPU 
assembly: 

OPDEF 
CPOP 
CPSYN 
PURGDEF 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




PPU 


J 



A character string beginning with J supplied in the variable field alters the way 
that COMPASS assembles the variable expression on UJK, ZJN, NJN, MJN, or 
PJN instructions. 

If J is not specified, COMPASS first tests the range of the expression against 
the short jump limit (+31). If the value is in range, COMPASS assembles the 
jump using the value of the expression. If the value is out of range, COMPASS 
performs a second test, this time using the expression value minus the 
location coimter value. If the value is now in range, COMPASS assembles the 
instruction using the expression value minus the location counter value. 
However, if it is out of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 



As a result, COMPASS is able to differentiate between an expression value 
that is an absolute address in the short jump range from an expression value 
that is a true relative address, 

A symbol in the location field, if present, is ignored. 
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Example: 



Location 


Code Generated 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 








I 




n 


18 ho 










FPU 




i _ 

1 




760 






TAG 


• 

UJM 


TAG-* 


1 
1 

j EXPRESSION < 
1 


?7B 


Location 


Code Generated 




lOCATION 


OPERATION 


VARIABIE 


COMMENTS 








I 




11 


18 


I30 












PPU 

• 


JUMP 


1 

1 




7«*0 
760 


3^7 




TAG 


• 

UJN 


20 P. 
TAG 


1 
{ 

JEXPRESSION-* 


< 37n 



4.3.4 PERIPH - CYBER 170 SERIES OR CYBER 70/MODELS 72, 72, 
74 OR 6000 SERIES PPU PROGRAM 

A PERIPH instruction declares a program to be a CYBER 170 Series or CYBER 70/Model 72, 73, 74, 
or 6000 Series absolute PPU program rather than a CPU program. If used, PERIPH must be in the 
first statement group. For a description of binary output produced as a result of this instruction, 
refer to the Loader Reference Manual, 

Floating point constants and the following instructions are illegal in a PPU assembly: 

ENTRY LCC REPI R= 

ENTRYC REP SEG Bl=l 

EXT REPC USELCM B7=l 

A symbol can be prefixed by =X if it is also defined conventionally. 

PPU programs permit sjrmbols of the form used for CPU register designators; they are normal 
symbols having no special significance. The following instructions are legal but are not applicable 
to PPU assemblies: 

OPDEF 
CPOP 
CPSYN 
PURGDEF 
Format: 



lOCATION 


OPERATION 


VARIABIE SUBPIEIDS 




PERIPH 


J 



J A character string beginning with J supplied in the variable field alters the 

way that COMPASS assembles the variable field expression on UJN, ZJN, 
MJN, or PJN instructions. 



4-10 



604 92600 A 



If J is not specified, COMPASS first tests the range of the expression value 
against the short jump limit (+31). If the value is in range, COMPASS assembles 
the jump using the value of the expression. If the value is out of range, COMPASS 
performs a second test, this time using the expression value minus the location 
counter value. If the value is now in range, COMPASS assembles the instruction 
using the expression value minus the location counter value. However, if it is out 
of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 

For an example illustrating how to use J, see the PPU pseudo instruction. 
A symbol in the location field, if present, is ignored. 

4.3.5 IDENT - IDENTIFY AND GENERATE OVERLAY 

Two or more IDENT pseudo instructions are permitted in CPU absolute or PPU assemblies. Second 
and subsequent IDENT instructions having nonblank variable fields cause generation of overlays. IDENT 
differs from SEGMENT in the way it generates overlays. Mrst, it allows the specification of overlay 
numbers. Second, the USE table and all block counters are reinitialized. The symbol table is not 
cleared; all symbols are reassigned absolute addresses relative to absolute zero. Thus, an ORG to a 
previously defined symbol restarts the absolute block at the symbolic address. The third difference is 
that normally the end of the overlay is determined by the last word address, the maximum origin 
counter value of the last block established in the overlay. A preceding SEG or SEGMENT can alter 
this, however (Section 3.4). 

For a CPU assembly, an IDENT with a blank variable field causes a partial binary write. The 
output is not terminated by an end-of-section or a new 77g table. However, the USE table and the 
block counters are reinitialized and each symbol in the symbol table is assigned an absolute address. 

Following an IDENT, COMPASS assumes that all blocks, including the literals block are complete. 
Block structuring starts fresh v/ith the new overlay or portion of binary. Thus, each new overlay or 
partial can use the same block names as are used by other overlays or partial and each can have a 
literals block. 

For a blank IDENT, an attempt to write into or reset the origin counter to a location in a partial section 
written separately causes a range error. Following the IDENT, the origin of the new absolute block 
is the next word after the binary written out, that is, it is lwa+1. 

The format of the IDENT varies according to the type of assembly as follows: 

CPU Absolute Format: 



lOCATION 


OPERATION 


VARIABLE SU8FIEIDS 




IDENT 


name , origin , entry f ij^ . i g 
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lOCATION 


OPESATION 


VARIABLE SUIFIEIDS 




roENT 





7600 PPU Absolute Format: 



lOCATION 


OPERATION 


VARIASIE SUSFIELDS 




IDENT 


name , origin, entry, ppu 



6000 Series PPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name, origin 



name Name of the overlay. For a CPU program, 1-7 characters, the first of which 

must be alphabetic (A-Z); for CYBER 170 Series or a CYBER 70/Model 72, 73, 
or 74 or a 6000 Series PPU program, 1-3 characters; for a CYBER 70/Model 76 
or 7600 PPU program, 1-7 characters. In all cases, the last character must 
not be a colon, A name is a loader linkage symbol required for overlays. 

origin An expression specifying the first word address of the overlay. The overlay 

control word and all code assembled starting with this address and ending with 
the next SEGMENT, nonblank IDENT, or END instruction comprises the overlay. 
For a single entry point CPU program, the load address for the overlay is 
origin-1. The word at origin-1 is overlayed by the 50g loader table. For a 
multiple entry point CPU program, the load address for the overlay is origin- 
wc-1, where wc is the number of entry points listed in the Slg loader table. 



For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words 
are overlayed by the 60-bit loader control table. Data can be generated in 
locations sta.rting with origin and above, but not below origin. The origin 
subfield does not serve the same function as ORG nor does it replace ORG for 
setting tlie origin counter. The origin of an overlay can be below the origin 
specified on any other IDENT or SEGMENT. 

entry An expression specifying the overlay entry address. When the overlay is 

called, control optionally transfers to this address. 

^1*^2 Absolute expressions specifying the level numbers of the overlay for CPU 

programs only, jt^ is the primary level (00-77g), jfg is the secondary level 
{00-77g), If base is M, S.^ and are assumed to be octal. If H-^ and jfg are not 
specified, ft^ is set to 01 and I2 is set to 00. 
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ppu An absolute expression specifying the number of the PPU in which the overlay 

is to be loaded. If base is M, ppu is assumed to be octal. 

A location field symbol, if present, is ignored. 

The binary is written on the file specified by the B parameter on the COMPASS control statement. END 
dumps the last overlay or completes a partially written section. 



Examples: 



The following program uses IDENT for overlay creation. Symbols T.OVL, O.DMPl, etc, are 
defined on a system text overlay. 



LOCATION 



Di*M 



JBW2 



OPERATION 



lOENT 

ABS 
BASE 
C0HHEN11 
LIST 
SST 
ORG 
QUAL 
SXO 



QUAL 
IDENT 
ORG 
SXO 



QUAL 

IDENT 

ORG 



END 



VARIABLE 



COMMENTS 



IP.ltT.OVL, 



10/07/70. C 



T.OVL 

OMPl 

Bl 



O.DHPl 



ONTROL CARD CALL.OHP. 



DMP2 

DHP2,T«0VL,0 

T.OVL 

86-t-l 



0HP9 

DMP.9,T.0VL, 
T.OVL 

0.DHP24-F.MDE 



30 



.0MP2 



0,DMP9 



OVERLAY 
OMPl 



OVERLAYS DHP2 
THROUGH 0HP8 



OVERLAY 
DHP9 



:nO OVERLAY DHP9 
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The following prt^ram uses EDENT instructions having blank variable fields, 



1617 



7116 



LOCATION 



FNT 



OPERA.TION 



IDENT 

A8S 

Of?G 



IT 



OENT 



IT 



lOENT 



IT 



VARIABIE 



COMMENTS 



130 



VVV,1 10B,ENT 
1 



,3 



,2 



First 
Partial Binary 



1 



Second 
Partial Binary 



Third 
Partial Binary 



J 



Origin- 
1617 



3455 



7116 



Iwa 



ABSOLUTE 



LITERALS 



Local Blocks 
ABSOLUTE' 



LITERALS' 
ABSOLUTE" 



LITERALS' 



Local Blocks 



Core Map 



First 
Partial Binary 



1 

Second 
Partial Binary 

J 



Third 
Partial Binary 

J 
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4.3.6 SEGMENT - GENERATE BINARY SEGMENT 



The SEGMENT pseudo instruction produces overlays at assembly time. It has many of the features of 
IDENT and is included primarily to provide another way of handling literals. Use of SEGMENT is 
intended for 6000 Series CPU absolute or PPU assemblies. For a relocatable subprogram, a SEG- 
MENT pseudo instruction causes BSSZ code and the FILL, REPL, and LINK relocatable tables to be 
written on the binary output file. 

The first SEGMENT causes all binary accumulated since the IDENT to be dumped as the main (0, 0) 
overlay. Each subsequent SEGMENT generates a new overlay with the specified level numbers. END 
dumps the last overlay. When COMPASS encounters a SEGMENT pseudo instruction, it does not clear the 
symbol table or block declarations. All blocks other than the block in use must be complete. For a 
CPU assembly, the literals block must be in one overlay only but that overlay can be any overlay. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


name 


SEGMENT 


origin.entry,!^,!^ 



name 



Name of overlay. For a CPU program, 1-7 characters, first of which must be 
alphabetic (A-Z); for a PPU subprogram, 1-3 characters. In all cases, the last 
character must not be a colon. It is a required loader linkage symbol. 



origin 



A relocatable expression specifying the first word address of the overlay. 
It can only be an address in the block in use. The overlay loader table and all 
code assembled starting at this address and ending with the next SEGMENT, 
nonblank IDENT, or END instruction comprises the overlay. 



entry 



V^2 



For a CPU program the load address for the record is origin-1. 
origin-1 is overlayed by the 50g loader table. 



The word at 



For a PPU subprogram., the load address is origin-5. Five 12-bit PPU words 
are overlayed by the 60-bit loader table. Data can be generated in locations 
starting with origin and above, but not below origin. The origin subfield does 
not serve the same function as ORG nor does it replace ORG for setting the 
origin coimter. The origin of an overlay can be below the origin specified on 
any other IDENT or SEGMENT. 

An expression specifying the overlay entry address. It is used for CPU 
assemblies only. When the overlay is called, control optionally transfers to 
this address. 

Absolute expressions specifying the level numbers of the overlay for CPU 
programs only. £^ is the primary level (00-77g), S.^ is the secondary level 

and ^2 are assumed to be octal. If and 



(00-77 J. If base is M, jf 
8 1 



are not specified, i is set to 01 and i is set to 00. 
1 ^ 
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Example: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


8 


ho 






TOE NT 
ABS 
ORG 
PSS 


SAM,PNTA 
llOR 


ENTRY POINT 




ovLOt: 


• 

fiSS 

• 


• 

• 


jOVFRLAY LOAD POINT 




SEGl 
STRT 


SFGHEN' 

ORG 

PSS 

nss 

• 


•*STRT,ENTR 
OVLOr 
1 

Q 

• 


loader taple 

Ifirst word of overlay 




ENTB 


• 

PSS 

• 


• 
• 


EXECUTION BEGINS HERE 






• 
• 

END 

1 


• 
• 


IeND or OVERLAY 



SEGl is loaded as an overlay upon a call for the loader from the program. The first word of the overlay 
is loaded at OVLOC +1, following the loader table. The entry point to the overlay and the first executable 
instruction is at ENTB. The overlay, when executed occupies the area of the main program beginning 
at OVLOC. 



4.3.7 SEG - WRITE PARTIAL BINARY 

The SEG pseudo instruction permits the generation of a CPU absolute subprogram or overlay in less core 
than would otherwise be required for assembly. It is illegal in PPU and relocatable assemblies. 

SEG causes COMPASS to write on the binary output file all binary information accumulated since the 
previous EDENT, SEGMENT, or SEG pseudo instruction. It does not write an end-of-section or begin 
a new PRFX table. A SEGMENT, IDENT, or END instruction completes the binary section. 

SEG does not affect the location and origin counters. The user cannot resume use of a block established 
prior to the SEG, except for the block in use when the SEG was encountered. An attempt to reset the 
origin counter so as to resume a block already written out causes an R error. Also, since the block 
group is incomplete and the names of the blocks already written out are still in the USE table, no new 
blocks can be established using the same block names as were used prior to the SEG. 

The literals block is written in the portion that contains the end of the absolute block. 
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Format: 



lOCATION 


OPERATION 


VARIABLE SUSFIEIDS 




SEG 





Symbols in the location field and variable field, if present, are ignored. 
Example: 





lOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




It 


!8 isO 






lOENT 

A8S 

USE 


• — — ^ 

NAME, ORIGIN, ENTRY 
t 

^ 1 






• 








• 


: 1 






SEG 
USE 


1 
1 






• 


1 






• 


• 






SEG 


1 






• 








• 


1 






• 

END 


1 
1 



4.3.8 STEXT - GENERATE SYSTEM TEXT RECORD 

As a result of an STEXT pseudo instruction, binary output for the subprogram consists of all symbols, 
micros, and opcodes (macros, opdefs, and machine and pseudo instructions), written in overlay 
format at the end of pass one. The STEXT instruction must be in the first statement group. 

The system text overlay becomes available in other assemblies through use of the G or S option on the 
COMPASS control statement (chapter 10). Through this feature, information in the system text overlay 
need be processed only once for all COMPASS programs asing the same system text. System text over- 
lays cannot be generated and used in the same assembly batch; system tex-t overlays generated by one 
COMPASS control statement call can be used only by assemblies performed by later COMPASS control 
statement calls. 

The symbols included in the system text overlay written are all symbols defined in the assembly except 
those for which at least one of the following is true: 

The symbol value is relocatable or external. 

The symbol is qualified. 
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The symbol is redefinable (i.e., defined by SET, MAX, MIN, or MICCNT). 
The symbol is defined by statements read by XTEXT or occurring between CTEXT and ENDX. 
The symbol is defined by SST (i. e. , is a system symbol input to the present system text assembly). 
The symbol is 8 characters beginning with t I . 
ill defined micros are included in the system text overlay. 

ill program-defined opcodes are also included. Machine and pseudo instructions automatically 
lefined by COMPASS, and opcodes defined by system text input (if any) to the assembly, are not 
ncluded. 

When a system text overlay is used as input to an assembly through the G or S option on a COMPASS con- 
trol statement, all of the micros and opcodes in the system text are automatically defined at the start of 
each assembly; however, the symbols in the system text are defined only for those assemblies that 
contain the SST pseudo instruction. 

A system text overlay on the library is an absolute overlay that has the following control table: 



59 48 42 36 00 



5000 


01 


01 


oooooooooooo 



Format of Text: 
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Format: 



LOCATION 


OPERATION 


VARIABLE SU8FIELDS 


rname 


STEXT 





rname Name assigned to overlay; 1-7 alphanumeric characters, of which the first must be a 
letter (A-Z) and the last must not be a colon. It is placed in the prefix table that 
precedes the overlay. 

If rname is blank, COMPASS uses the name from the IDENT instruction and generates 
the system text only. Otherwise, the system text is generated in addition to the re- 
locatable or absolute binary and precedes the binary output on the binary file. 

An entry in the variable field, if present, is ignored. 
Example: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 ho 








1 ' ' ' ... 






lOENT 


SYSTEXT 


1 








STEXT 












BASE 


MIXED 


1 






MPRS 


EQU 


100 


1" 


1 




• 


• 


• 














'SYSTEH CONSTANTS, SYHBOLS, 










|aNO COMHUNICATIONS AREAS 




• 


• 


• 










• 


• 


1 






FRTS 


EQU 


1177 


! - 






IXX/X 


OPDEF 


If J,K 


f ' 






• 


• 


• 


! 






• 


• 


• 


'SYSTEM-DEFINED MACROS 




• 




• 


^AND OPOEFS 






ENOM 




1 






SYSCOM 


MACRO 


N 


1 






• 


• 


• 








• 


• 


• 


1 






• 


• 

ENOH 


• 


r 






DATE 


MICRO 


1,10,*,..» 








• 


• 


• 


1 






• 


• 


• 


iSYSTEM-DEFINEO MICROS 






END 


• 
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4.3.9 COMMENT— PREFIX TABLE COMMENT 



The COMMENT pseudo instruction inserts the character string specified in the variable field into 
the eighth through fourteenth words of the PRFX table in the object program. The prefix table, and 
thus the comment, is ignored by the loader but identifies the section. If a subprogram contains more 
than one COMMENT instruction, the new comments are appended to the table for the most recent 
binary control statement. If the subprogram contains a NOLABEL instruction, the COMMENT instruc- 
tion is meaningless. COMMENT instructions following SEG and blank IDENT pseudo instructions are 
ignored without notification. 

Format: 



lOCATlON 


OPERATION 


VARiASlE SUBflELDS 




COMMENT 


String 



string COMPASS searches the columns following the blank that terminates the operation 
field. If it does not find a nonblank character before the default comments tDolumn 
(see COL pseudo instruction), it tal^es the characters starting with the default 
comments column minus one. Otherwise, the character string begins with the first 
nonblank character following the operation field. In either case, the last character 
of the string is the last nonblank character of the statement.' 1 to 10 blanks are 
appended on the right so that the string is followed by at least one blanic and the 
length of the string is a multiple of 10 characters. If the variable and comment fields 
are all blanks, the string consists of 10 blanks. If the string length is more than 70 
characters, all characters beyond the 70th are lost. 

A location field symbol, if present, is ignored. Refer to section 4, 3. 5 for an example. 
4.3.10 NOLABEL - DELETE HEADER TABLE 

The NOLABEL instruction modifies the format of the binary output produced by COMPASS for an 
absolute assembly by optionally suppressing header information. It is particularly convenient for 
generating deadstart programs which must be loaded at location zero. 



Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




NOLABEL 


I 
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I Optional; if the variable field contains a character string beginning with an I, 

COMPASS suppresses all prefix (7700g) tables, but retains the other program 
header tables. 



If the I option is omitted, COMPASS suppresses all of the following: 

Prefix tables iHQOg) 
Overlay control tables (5OOO3) 
Multiple entry point tables (SlOOg) 
PPU header control tables 



A location field symbol, if present, is ignoredo NOLABEL is illegal in a relocatable CPU assembly. 



4.3.11 LCC-LOADER DIRECTIVE 

The LCC pseudo instruction provides a means of including loader directives v/ith the tables for a 
relocatable program. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LCC 


directive 



directive First nonblanic character following LCC to the first blank. For directive 

formats, refer to the Loader Reference Manual. 

A location field symbol, if present, is ignored. 

COMPASS writes a directive as a section in packed display code for subsequent interpretation by the 
loader. COMPASS does not edit the directive; the loader recognizes illegal forms at load time. 

4.3.12 LDSET-GENERATE LDSET OBJECT DIRECTIVES 

The LDSET pseudo instruction generates loader LDSET directives for a relocatable program. A 
program may contain any number of LDSET instructions. COMPASS collects all LDSET options and 
writes a single LDSET (7OOO3) table in the relocatable binary output between the PRFX (TTOOo) 
table and the PIDL (34003) tables. The LDSET table is not written if LDSET instructions do not 
appear in the program. LDSET is not allowed in a PPU or absolute CPU assembly. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LDSET 


options 
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.ions 



One or more options separated by commas. 



LIB 

LIB=libname 

iVlAP 
MAP=p 



MAP=p/lfn 
MAP=/lfn 

PS=p 
PD=p 



PRESET=p 



PRESETA=p 



ERR=ALL 



Clear local library set. 

Add the specified libraries to the local library set. More than one library can 
be specified by separating library names with a slash, in the form: 

libnamei/libname2/.../libnamej^ 

Write load map to file OUTPUT. 

Write load map to file OUTPUT. Map items are selected by p: 

N No map. 

5 Statistics. 
B Block list. 

E Entry point list. 

X Cross reference map. 

p can be written as N or as any combination of SBEX in any order. 

Write load map to file named Ifn. p is as above. 

Write load map to file named Ifn. Installation default determines items on 
the map. 

Select page size for load map by a specification of number of lines, p can be 
decimal 10 through 999999. A value outside this range results in the 
installation default page size. 

Select print density for load map by a specification of decimal number of 
lines per inch, p can be: 

6 6 lines per inch. 

8 8 lines per inch. 

other Installation default. 

Preset memory to the value specified by p. Under NOS/BE, p can be a 1 
through 20 digit octal number with an optional + or - prefix and an optional B 
suffix. 

p can also be one of the following key words: 

NONE No presetting for ECS; same as ZERO for CM 

ZERO 
ONES 
INDEF 
INF 

NGINDEF 
NGINF 
ALTZERO 
ALTONES 
DEBUG 

p can be as defined for PRESET. The lower 17 bits (CM/SCM) or lower 24 
bits (ECS/LCM) of each word contains its address. This option is not 
supported by SCOPE 2. 

Select loader abort for all errors. 



0000 


0000 


0000 


0000 


0000 


7777 


7777 


7777 


7777 


7777 


1777 


0000 


0000 


0000 


0000 


3777 


0000 


0000 


0000 


0000 


6000 


0000 


0000 


0000 


0000 


4000 


0000 


0000 


0000 


0000 


2525 


2525 


2525 


2525 


2525 


5252 


5252 


5252 


5252 


5252 


6000 


0000 


0004 


0040 


0000 
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ERR=FATAL 



Select loader abort only for fatal errors. 



ERR=NONE 
REWIND 

NOREWIN 

EPT=eptname 

NOEPT=eptname 
USEP=pname 

USE=eptname 



COMMON 



GOMMON=blkname 



SUBST=pair 



OMrr=eptname 



Select loader abort only for catastrophic fatal errors. 

Reset the default REWIND/NOREMN option for load files to REMND. The 
NR parameter on LOAD and SLOAD directives can override this default for 
individual files. 

Reset the default REMND/NOREMN option for load files to NOREWIN. The 
R parameter on LOAD and SLOAD directives can override this default for 
individual files. 

If the symbol eptname is defined, declare it an entry point of the CAPSULE 
or OVCAP binary subsequently generated by the loader in the form: 

pnamei/pname2/.../pnamef^ 

Do not define eptname as an entry point of the CAPSULE or OVCAP binary 
subsequently generated by the loader. 

Cause the designated object modules to be loaded whether or not they are 
needed to satisfy external references. More than one module can be 
specified by separating module names by a slash. 

Cause the load of object modules containing the specified entry points 
whether or not they are needed to satisfy external references. More than one 
entry point can be specified by separating entry point names by a slash in the 
form: 

eptname2^/eptname2/.../eptnamen 

Assign all labeled blocks to a segment such that the blocks are available to 
all segments that reference them. Valid for segment loads only. 

Assign the labeled common block named blkname to a segment such that it is 
available to all segments that reference it. Valid for segment loads only. 
More than one block name can be specified by separating the individual olock 
names with a slash in the form: 

blknamex/blkname2/.../biknamefj 

Treat external references to eptname^^ as though they were references to 
eptname2, where the entry point names are specified as a pair in the form: 

eptnamei-eptname2 

More than one pair of entry point names can be specified by separating the 
pairs with a slash in the form: 

pairi/pair2/.../pairn 

Omit satisfying external references to the specified externals. More than 
one entry point name can be specified by separating the names with a slash in 
the form: 



eptnamei/eptname2/.../eptnamen 
A location field symbol, if present, is ignored. 

See the Loader reference manual for details of these parameters, including the operating system to which a 
given option applies. 
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i MODE CONTROL 



Kle control pseudo instructions influence the basic operating characteristics of the assemblero 
3cifically, the instructions allow the programmer to alter the way in which the assembler: 

Interprets binary data BASE pseudo instruction 

Generates character data CODE pseudo instruction 

Interprets the beginning of comments on statements COL pseudo instruction 

Qualifies symbols or does not qualify them QUAL pseudo instruction 

Interprets the R= instruction Bl=l or B7=l pseudo instruction 

each case, the assembler has a default mode which it uses if one of these instructions is never used. 



4.1 BASE -DECLARE NUMERIC DATA MODE 

e BASE pseudo instruction declares the mode of interpretation for numeric data for which a base 
dix is not explicitly defined. Use of the BASE pseudo is optional; if BASE is not used in a subpro- 
am, COMPASS evaluates unspecified numeric data as decimal. 

I alternate application of BASE is to define the previous base as a micro. 

addition, if no program or system micro named BASE has been defined, COMPASS changes the 
:edefined BASE micro to be a single letter D, M, or O, corresponding to the new mode established 
this BASE instruction. 

trmat: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


mname 


BASE 


mode 



mname Optional 1-8 character micro name by which the previous BASE mode can be referenced 
in subsequent BASE instructions. If mname is present, the value of the micro nam^ed 
mname is (re)defined to be a single letter D, M, or O, corresponding to the BASE mode 
in effect prior to this BASE instruction. 

mode Blank, in which case the base remains unchanged, or 1-8 characters, the 

first of which designates the new base as follows: 

O Octal assembly base; any subsequent use of a data item not 

specifically identified by an O, D, or B prefix or suffix is 
evaluated as octal. For example, the constants 15 and 15B 
are evaluated as 15g; constant 15D is evaluated as 17 g. Any 
item containing an 8 or 9 without a D radix is flagged as 
erroneous. Exceptions are scale factors, character counts, 
shift counts (S modifier), and binary point positions, which 
are always considered decimal. 
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D Decimal assembly base; any subsequent use of a data item 

not specifically identified by an O, D, or B prefix or suffix 
is evaluated as decimal. 

M Mixed assembly base; any subsequent use of a data item not 

specifically identified by an O, D, or B is evaluated as decimal 
if it is one of the following. Otherwise, it is evaluated as 
octal. 

VFD bit count 

IF, ELSE, or SKIP line count 

MICRO, OCTMIC, or DECMIC character count 

B, C, or I subfield in REP or REPI 

DUP or ECHO line count 

Character count 

Shift counts (S modifier) 

Scale factors 
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Binary point position 
COL column number 
DIS word count 
SPACE line count 

* Use base in effect prior to current base. The assembler records 

occurrences of BASE pseudo instructions and maintains a table 
of the most recent 50 occurrences. Each BASE * resumes use 
of the most recent entry and removes it from the list. When the 
subprogram contains more BASE * instructions than there are 
entries in the stack, COMPASS uses a decimal base. 

other If the variable field is not blank and does not contain one of the 

above, COMPASS sets an error flag. 



Examples: 



This example illustrates the affect of BASE on a VFD instruction that defines a 48-bit field 

containing 10 . 

8 



Code Generated 



QOOOOOOI^OOCOOQIO 



Di»0 



0<»0 



QOQOtlQOOOOlO 



OOOOOOUO 



OOOQOQIO 



LOCATION 



OPERATION 



BASE 
VFO 



BASE 
VFO 



BASE 
VFO 



VARIABLE 





&S/iO 







%8/iO 



COMMENTS 



30 



The following example illustrates the micro capability of BASE: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 ho 












SAVEB 


BASE 


M 


ISAVE BASE IN USE 




• 


• 


• 


1 




• 


• 




jCODE USING BASE M 




• 


• 


• 


IrESTORE SAVED BASE 






BASE 


#SAVEB3t 






BASE 


RESTORE SAVED BASE 




• 


• 


• 


1 




• 


• 


• 


1 




• 


• 


■ 


1 
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44.2 CHAR-DEFINE OTHER CHARACTER DATA CODE 

The CHAR pseudo instruction defines character data codes to be used when the CODE O (for Other) 
mode is in effect. 

Format: 



lOCATION 


OPERATION 


VARiABLE SUBFIEIDS 




CHAR 


expl , exp2 



expl Evaluatable absolute expression whose value is 00 to 778 . Ttie value of expl 

is the display code value of the character to be redefined. 

exp2 Evaluatable absolute expression whose value is 00 to 778* The value of exp2 

is the new code other value of the character designated by expl. 

A location field symbol, if present, is ignored. 

Initially, all code other values are tiie same as display code. CHAR need be used only for those 
characters whose code other values are different from display code. Characters may be redefined 
as many times as desired by subsequent CHAR pseudo instructions. 

Example: 





lOCATION 


OPERATION 


VARIABLE SUBPIEIDS 


00r»63 
63^00 




CHAH 
CHAR 


0»63B 
638 »0 


INTtKCHANOE 
PERCENT FOR 


COLON AND 
COOL OTHER 



4.4.3 CODE - DECLARE CHARACTER DATA CODE 

The CODE pseudo instruction declares that until the next CODE pseudo instruction is encountered all 
constants, character strings, and character data items are to be generated in the specified code. 
Character data can be generated in ASCII t, display, external BCD, or internal BCD, codes. If no 
CODE instruction is used, COMPASS generates display code. Codes are given in appendix A. 

An alternative application of CODE is to define the previous code as a micro. 

In addition, if no program or system micro named CODE has been defined, COMPASS changes the 
predefined CODE micro to be a single letter A, D, E, I, or O, corresponding to the new mode 
established by this CODE instruction. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


mname 


CODE 


char 



t American Standard Code for Information Interchange. 
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mname Optional 1-8 character micro name by which the previous CODE mode can be reterenced 
in subsequent CODE instructions. If mname is present, the value of the niicr : named 
mname is (re)defined to be a single letter A, D, E, I, or O, corresponding t-. :-e CODE 
mode in effect prior to this CODE instruction. 

char The first character of a string indicates the code conversion: 

A ASCII six-bit subset 
D Display 
E External BCD 
I Internal BCD 

O Other code, defined by CHAR pseudo instructions. 

* Use code in effect prior to current code. The assembler records occurrences of 
CODE pseudo instructions and maintains a table of the most recent 50 occurrences. 
Each CODE * resumes use of the most recent entry and removes it irom the list. 
When the subprogram contains more CODE * instructions than there are entries in 
the stack, COMPASS generates display code. 



Example: 



Code Generated 




LOCATtON 


OPERATION 


VARIABLE COMMENTS 




I 




11 


18 l30 


17Z5ZkZQ25ZhQQQQiiQQQ 






DATA 


OLOUTPUT 1 








CODE 


ASCII 








DATA 


OLOUTPUT 1 


Af»E 






CODE 


EXTERNAL BCD 








DATA 


OLOUTPUT 1 


Ef*I 






CODE 


INTERNAL 8C0 








DATA 


OLOUTPUT 1 








CODE 


DISPLAY , 


17252i»20252if00000000 






DATA 


OLOUTPUT 1 


Oi*I 






CODE 


i 








DATA 


OLOUTPUT 1 



4.4.4 QUAL - QUALIFY SYMBOLS 

The QUAL pseudo instruction signals the beginning of a sequence of code in which all s^inbols defined 
in it are either qualified or are unqualified (global). If no QUAL is in a subprogram, all sj-mbols are 
defined as global. 

An alternative application of QUAL is to define the previous qualifier as a micro. 

In addition, if no program or system micro named QUAL has been defined, COMPASS changes the 
predefined QUAL micro to be the new qualifier name established by this QUAL instruciioa. 
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Within a QUAL sequence in wliich a symbol is defined, a symbol reference need not be qualified^ 
Used outside the sequence, the S5mibol must be referenced as /qualifier /symbol. Thus, a symbol and 
a qualifier become a unique identifier local to the sequence in which the symbol was defined. The 
same symbol used with a different qualifier is local to a different QUAL sequence. If a symbol is 
defined with no qualifier as well as being defined as qualified, a reference to the symbol within the 
QUAL sequence is assumed to be a reference to the qualified symbol rather than to the global symbol. 
In this case, a reference to the global symbol must be written as // symbol. However, in a 
NOREF statement when the unqualified symbol is previously defined and the qualified symbol is not, 
COMPASS assumes the reference is to the unqualified symbol. 



Default symbols and linkage symbols are not qualified. 



lOCATION 


OPERATION 


VARIABLE SUBFIEIOS 


mname 


QUAL 


qualifier 



mname Optional 1-8 character micro name by which the previous qualifier can be 

referenced in subsequent QUAL instructions or symbol references. If mname 
is present, the value of the micro named mname is (re)defined to be the 0-8 
characters comprising the qualifier in effect prior to this QUAL instruction. 

qualifier A symbol qualifier or * or blank, as follows: 

qualifier 1-8 character name, the first character of which cannot be $ or 

= or : or numeric. The qualifier cannot contain the characters 

+ - / , or A 
A blank terminates the qualifier. 

Any symbol defined subsequent to this QUAL up to the next 
QUAL must be referenced from outside the QUAL sequence as 

/qualifier/symbol 

The current qualifier appears as the third sub-subtitle on the 
assembly listing (section 11.1). 

* The assembler resiunes using fiie qualifier in use prior to the 

current qualifier. The assembler records occurrences of QUAL 
pseudo instructions and maintains a table of the most recent 50 
occurrences. Each QUAL * resumes use of the most recent entry 
and removes if from the list. When the subprogram contains more 
QUAL * instructions than there are entries in the stack, 
COMPASS uses the null (global) qualifier. 
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blank 



A blank variable field causes any symbols defined up to the next QUAL to be 
global. A global symbol does not require a qualifier. 



NOTE 

The first attempt to redefine a global symbol from 
within a QUAL sequence results in A and U errors. 
The symbol is defined local to the QUAL sequence 
with a zero value. To avoid fatal errors, precede 
any redefinition instruction (SET, MAX, MIN, or 
MICCNT) within a QUAL sequence with a blank QUAL 
and follow it with a QUAL *. 



Examples: 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




u 


18 ho 






QUAL 


f ASSl 


1 








• 


F 

e 


taCOE QUALIFIED 
1 


3V PASSl 






• 

FO 


• 

LOCI 


1 








OUftL 


PASS? 


1 






nCOE 


EQU 


L0C2 


•rCDE QUALIFIED 


BY PASS? 






DUAL 


• 


[SYHROLS GLOBAL 
1 


FROM NOW ON 




GLOB 


BSS 


• 

n 
• 


1 

|GLOB IS GLOBAL 








RJ 


/PASSl/BCDF 
• 


1 

|JUMP TO PASSl 


ROUTINE 






RJ 


• 

/PflSS?/RCDE 


1 

lJUHP TO PASS? 


ROUTINE 
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Location Code Generated 



7f TT??77 7?7?7?7???T€v 





lOCATlON 


OPERATION 


VARIABLE COMMENTS 


I 




n 


58 ho 




f fin 


« Vj r\ U 


™ la, \J\ 1 «^ ^ ^ ¥^ l« W 1 




















f r* V? J. 


BS? 








VFD 








US? 








QUAL 


1 






FNOM 


1 
1 






TAB 


1 

OMFjOMF 1 






USE 


OtIE . 














BSS' 


IfIB 1 




Tar,? 


vrn 










^ ■ ' 








* 1 














TBB 


TWO, TWO j 






m£ 


TIIO 






QUAL 






TAGl 








T iiG? 


VFO 








USE 























lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


!8 (30 




21 


QUAi 
8SS 


2 



— r— ^ 

III QUALIFIED BY 2 






• 


• 


i: 






• 


• 






Zl 


• 

DUAL 


• 
B 

/Z/Zl 


I- 

.EQUATE SYMBOLS SO THAT 
|Z1 IN 2 CAN BE REFERRED 



|T0 AS Zl IN B 



4.4.5 Bl = 1 AND B7 = 1 - DECLARE THAT B REGISTER CONTAINS ONE 

The Bl=l and B7=l pseudo instructions declare that in this CPU subprogram, the contents of the Bl 
register or the B7 register, respectively, are one. These instructions do not produce code; they alter 
the way in which code is generated by the R= instruction (section 4. 8.7) and define the symbol Bl=l 
or B7=l. If more than one instruction is used, the assembler uses the last one encountered. 
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Formats: 



IOC AT ION 


OPERATION 


VARIABLE SUBFiElDS 




Bl=l 
B7=l 





A symbol in the location or variable field is ignored. 

Note that loading the respective B register with one is the user's responsibility. 
For an example of use, refer to R= (section 4.8.7). 

4.4.6 COL - SET COMMENTS COLUMN 

The COL pseudo instruction sets the column number at which the comments field can begin when the 
variable field is blank. If no COL instruction is used in the subprogram, COMPASS uses 30. 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




COL 


n 



n An absolute evaluatable expression designating the column number; n^l2. When base is M, n 

is assumed to be decimal. If n is less than i2, COMPASS sets the column at 12. If a is zero 
or blank, COMPASS sets the column to 30, the default column. 

If the current operation field extends past the current comments column, COMPASS 
substitutes a very large number for n in the current instruction only; that is, if n is less than 
or equal to the last column of the operation field, a variable field must be present if a 
comment is present. 

A location field symbol, if present, is ignored. 

Example: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




n 


18 ho 














COL 
USE 


36 


|*^ETURN TO BLOCK 



In this example, subsequent statements for which the variable field is blank cannot have comments 
beginning before column 36. 
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4.5 BLOCK COUNTER CONTROL 

Counter control pseudo instructions establish local blocks, labeled common blocks, and blank common 
blocks in addition to the absolute, zero, and literal blocks established by the assembler; they control use of 
all program blocks, and provide the user with a means of changing origin, location, and position counters. 



4.5.1 USE - ESTABLISH AND USE BLOCK 

USE establishes a new block or resumes use of an already established block. The block in use is the iilock 
into which code is subsequently assembled. A user may establish up to 252 blocks in a block group. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




USE 


block 



block Identifies block to be used, as follows: 

or blank Nominal block (absolute or 0). 

// Blank common block; for a relocatable subprogram, this block cannot 

contain data. The only storage allocation instructions that can follow are 
BSS and ORG. The BSSZ instruction is illegal because it presets the block 
to zeros. 

/name/ Labeled common block. A name can be a maximum of 7 characters and 

cannot include blank or comma. The first and last characters must not oe 
colons. Conventions imposed by the loader or other assemblers or 
compilers could further restrict the use of names. 

name Local block. A name can be 1 through 8 characters, excluding blank or 

comma. The first character must not be a colon. Use of this name 
enclosed by brackets does not cause the block to become a labeled common 
block. For example, USE A and USE/A/ are different blocks. 

* Block in use prior to current USE, USELCxM, ORG, or ORGC. See 

discussion following. 

A location field symbol, if present, is ignored. 

The nominal program block contains the entire program if no USE or USELCM is encountered. 

Redundancy between block names is permitted as follows. 

A labeled common block designated by /O/ can coexist with the program block designated by 0. Blank 
common designated by // can coexist with a labeled common block designated as ////. 
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A CPU subprogram may have two blocks with the same name and the same memory type if they hare 
different block types (local or common). Furthermore, a CPU subprogram may have two blocks 
with the same name and the same block type if they have different memory types (CM/SCM or 
ECS/LCM). Thus, altogether, there may be up to four different blocks v/ith the same name. 

When a block is first established, its origin and location counters are zero and its position counter : = 
either 60 (CPU subprogram) or 12 (PPU subprogram). When a different block than that in use is 
indicated, COMPASS saves the values of the current origin and position counters along with an 
indicator as to whether the next instruction is to be forced upper. If the most recently assembled 
instruction under the block is one that forces the next instruction upper, the first instruction 
assembled upon resumption of the block is forced upper. When, the designated block has'been 
previously established, COMPASS resumes assembly in the block using the last known values for 
the origin and position counters. The value of the location counter is not saved. Upon resumption of 
the block, it is set to the value of the origin counter. If a LOC had been used previously, resetting 
of the" location counter to produce the desired results is the responsibility of the programmer. 

The assembler records occurrences of USE, USELCM, ORG, and ORGC pseudo instructions (except 
USE * and USELCM *) and maintains a USE table of the most recent 50 occurrences. Each USE * and 
USELCM * resumes use of the most recent entry and removes it from the table. When the subprogram 
contains more USE * or USELCM * Instructions than there are entries in the stack, COMPASS uses 
ttie nominal block. 



Examples: 



Location Code Generated 




— 5 

LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


Iso 








USE 






13 OlOQOOOOOO 




GAMMA 


«J 


ALPHA 


1 BLOCK IN USE 








USE 


DATAl 


1 BLOCK DATAl IN USE 


35 1720^000000000000000 




SAB 


DATA 


1. 










USE 




! RESUME USE OF BLOCK 


Ik 5130000000 






SA3 


SAH 





Note that the SA3 is forced upper because the RJ causes a force upper of the next instruction in the 



DIOCK. 












Location Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




11 


18 |30 








USE 


TABLE 


i USE TABLE LOCAL BLOCK 


2615 00 






VFO 


6/0 


1 RESUME PREVIOUS BLOCK 
• 






USE 
• 


* 
• 








• 

USE 


• 
• 

TABLE 


1 * 
1 • 

RESUME USING TABLE 


3Q002600 -1- 






VFO 


6/lRX,18/S 


[resume PREVIOUS BLOCK 






USE 





Note how separate blocks can be used to facilitate packing of partial-word bytes into a table residing in 
a block other than the one primarily being used. 
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The USELCM pseudo instruction establishes or resumes use of a block assigned to extended core 
storage (ECS) or large core memory (LCM). For all ECS/LCM blocks in an absolute CPU assembly, 
and for the ECS/LCM blank common block in a relocatable assembly, data generating instructions 
(including BSSZ) and symbolic machine instructions are illegal; only storage reservation pseudo 
instructions (BSS, ORG, and ORGC) are allowed. The USELCM pseudo instruction is illegal in PPU 
assemblies. 



Format: 



lOCATlON 



OPERATION 



USELCM 



VAIiASlE SUBFIEIDS 



block 



block: 



Identifies block to be used, as follows: 



or blank 
// 



name 



Illegal. 

Blank common block. A subprt^ram can have two blank common 
blocks If one of them is in ECS/LCM. 

Labeled common block. The name can be a maximum of 7 
characters and cannot include blank or comma. The first and last 
characters must not be colons. The loader or other assemblers or 
compilers could further restrict the use of names. 

Local block, t The name can be 1-8 characters, excluding blank or 
comma. The first character must not be a colon. Use of this name 
enclosed by brackets does not cause the block to become a labeled 
common block. For example, A and /A/ are different blocks. All 
of the local ECS/LCM blocks are concatenated to form a single block, 
which is treated by the loader as an ECS/LCM common block whose 
name is unique to the subprogram. 

* Block in use prior to current USE, USELCM, ORG, or ORGC. 

A location field entry, if present, is ignored. 

The length of each ECS/LCM block, including the combined local block, is rounded up, if necessary, 
to an integral multiple of eight 60-bit words. The maximum size of an ECS/LCM block is 1,048, 568 
words. 



Further rules for USELCM are the same as for USE. 



t SCOPE 2 does not currently allow local blocks in LCM. 
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Examples: 





lOCATION 


OP£RAT!ON 


VARIABLE 


COMMENTS 


1 




n 


IS 


130 






BASE 





H ^ — 

1 
1 








LCH 


1 

jESIABLISH mo USE LUH BLOCK 




LCMC 







jUEFlNE SYiiBOL LCMC 




8L0C1 


BSS 


100 


jRESERVE 100 HOROS 




BL0C2 


BSS 




•RESERVE 200 HOROS 






• 


e 


|R£SUME PREVIOUS BLCUK 






ORG 


• 

8LOCl>100aB 


1 
1 

'reserve 20 HORE HOROS 




8L0C3 


BSS 


20 






USE 




jRESUHE PREVIOUS BlQLK 



4.5.3 OKG AND ORGC - iEJ ORIGIN COUNTER 

ORG Indirectly indicates the block to be used for assembly of subsequent code and specifies the value 
to which the origin and location counters are to be set. CJOMPASS makes an entry in the USE table and 
saves the current origin and position counter values. 

ORGC t indirectly indicates the block to be used for assembly of subsequent code ai^d specifies the value 
to which the origin and location counters are to be set. COMPASS makes an entry in the USE table and 
saves the current origin and position counter values. In a PPU or absolute assembly, ORGC is the 
same as ORG. In a relocatable CPU assembly, ORGC is the same as ORG if the USE block specified 
by the address expression is not a common block; otherwise, code following an ORGC is ignored by 
the Unking loader if that common block was first declared by a previously loaded subprogram. If two 
or more programs in a load sequence preset relocatable text within the same common block, the ORGC 
must be used; otherwise, multiple relocation of those words can occur. 

Formats : 



lOCATION 


OCEKATION 


VA8IASIE SUeflELOS 




ORG 






ORGC 





exp Expression specifying the address to which the origin and location counters are to be 

set. Following ORG or ORGC, the assembly resumes at the upper position of the 
location specified. COMPASS determines the block as follows: 



t Not supported by SCOPE 2 Loader. 
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lo If the expression contains a symbolic address, COMPASS uses the block in 
which the symbol was defined. 

2. COMPASS uses the current block if the value of the expression is *, *L, or 
*0. If the origin and location counters are the same value, and no cocie has 
been assembled in the current location, the only effect of *, *L, or *0 is to 
force the next instruction upper. If a word is partially assembled, however, 
the code already assembled into the location is losto 

If the counter values differ, * or *L sets the origin counter to agree with the 
location counter value; *0 sets the location counter to the origin counter value= 

3o An absolute expression causes use of the absolute block. In a relocatable 
assembly, this is the only way to establish the absolute block. All symbols 
defined in the absolute block are absolute. 

Any symbols in the expression must be already defined in the assembly and must not result in a 
negative relocatable value. It is not possible to ORG or ORGC into the literals block. 

A location field symbol, if present, is ignored. 

Once an ORGC pseudo instruction has established the conditional loading indication for a given common 
block, it is in effect whenever assembly in that block is resumed by subsequent USE or USELCM 
pseudo instructions, and can be cleared only by an ORG pseudo instruction specifying that block. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




n 


18 ho 














USE 


ALPHA 








• 


• 


1 « 






• 


• 


1 • 






• 


• 






A8C 


DATA 


20,100 ,1000 


ILOCATEO IN ALPHA 




XY7 


• 

USE 
BSS 
• 
• 


BETA 


• 

• 

jLOCATED IN BETA 
> • 
• 






• 

ORG 
• 


A8C 


ISETS ALPHA COUNTERS TO ABC 
|ANO RESUMES USE OF ALPHA 






BSS 


1800 


1 • 






• 




• 






« 
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LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 


11 


18 i30 




ORG 
* 


50 


ISETS ABSOLUTE BLOCK COUNTER 
jTO 50 AND BEGINS ITS USE 




« 


« 

XfZ+iQfl 

* A. • ^ U U> 


• 

ISETS SETA COUNTERS TO XYZ+IOQ 








j « 




• 




r 




• 




IRESUHES ABSOLUTE BLOCK 
U 






• 


• 


1 
1 




• 


• 


. • 

'RESUMES BLOCK ALPHA 
1 

• 




• 


• 




• 


e 






• 

USE 


« 


u 

|RESUMES BLOCK BETA 




• 


e 


I- 




• 


• 


r 




• 


• 


i: 




• 

USE 


• 


IRESUHES BLOCK ALPHA 




• 


« 






• 


• 


i: 




• 

USE 


e 


'RESUHES NOMINAL BLOCK 
I 


DATA 


• 

USE 
BSS 
ORGC 
DATA 


* /DATA/ 



DATA 
1,2,3 


i 

1 

ICONOITIONALLY PRESET DATA 
1 


FOUR 


USE 

CON 

USE 

DATA 

DATA 


ANYBLOCK 
3RXfZ 

5,6 


1 

'UNCONDITIONAL DATA 

[return to /DATA/ STILL 
' CONDITIONALLY SKIPPING 

1 




ORG 

ZR 

RJ 

• 

• 

• 


FOUR 

XI, ERROR 
SUB£* 


I UNCONDITIONALLY LOADED 

jlNSTRUCTIONS 

1 
1 



4.5.4 BSS— BLOCK STORAGE RESERVATION 

The BSS instruction reserves core in the block in use by adjusting the origin and location counters. It 
does not generate data to be stored in the reserved area. A primary application is for reserving bMc 
common storage. It can also be used to reserve an area to receive replicated code (see REP, REPC, 
andREPI, section 4o 8. 8). 
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Format: 



LOCATION 


OPERATION 


VARiABlE SUBFIELDS 


sym 


BSS 


aexp 



sjrm If present, sym is defined as the value of the location counter after the force 

upper occurs. It is the beginning symbol for the storage area. 

aexp Absolute expression specifying the nimiber of storage words to be reserved. 

All symbols must be previously defined; aexp cannot contain external symbols. 
The value of the expression can be negative, zero, or positive and the value 
is added to both the origin counter and the location counter. A BSS or an 
erroneous expression causes a force upper and symbol definition but no storage 
is reserved. 

Example: 



LOCATION 



OPERATION 



VARIABLE 



COMMENTS 



30 



COMMON 



TAG 



USE 
BSS 
USE 



SA6 



BSS 



IQOOB 



COMMON«-500P 



RESERVE 512 WORDS OF BLANK COMMON 



DEFINE SYMBOL TAG 



4.5.5 LOC - SET LOCATION COUNTER 

A LOC pseudo instruction sets the value of the current location counter to the value in the variable 
field expression. The location counter is used for assigning address values to location symbols. 
Changing the location counter permits code to be generated so that it can be loaded at the location 
controlled by the origin coimter and moved and executed at the location controlled by the location 
counter. Thus, any addresses defined while the location counter is different from the origin counter 
will be correctly relocated only after the code is moved. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LOC 


exp 
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®^ Relocatable expression specifying the address to which the location counter 

is to be set. Any symbols in the exijression must be already defined in the 
assembly and must not result in negative relocation. 

A location field symbol, if present, is ignored. 

Following a LOG, if the value of the location counter differs from the origin counter, the location field 
IS flagged with an L on the listing until a LOG *0, USE, ORG, ORGG, or USELGM instruction resets the 
location counter to the value of the origin counter. 

A LOG instruction does not affect the origin counter except that it causes the next instruction to be 
forced upper. The only effect of LOG* or LOG *L is to force upper. Because GOMPASS does not 
save the value of the location counter when it switches blocks, a USE, ORG, ORGG, or USELGM for 
a different block effectively resets the location counter to the origin counter value. When use of the 
block IS resumed, it is the responsibility of the user to reset the location counter to produce the desired 
res m ts • 

Example: 

In the following example, the first LOG is used to generate PPU code that is to be loaded into one 
PPU and transmitted to a different PPU for execution. The second LOG is used so that on the listing 
the address field contains the table ordinal rather than a load address. At the end of the table, a LOG 
instruction changes the location counter to resume counting under the first LOG. At the end of the 
program, LOG *0 returns the location counter to the value of the origin counter. 



Location 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


Code Generated 


I 


11 


18 ho 




1 


Tl 


EQU 


1 


-1 ^ 







CM 


EQU 





1 


7100 






ORG 


710n 


1 


7100 




RFS 


BSS 







L 100 






LOC 


100 


i 


L mo 




PPR 


PSN 





1 
1 


L 101 


2i»0 




PSN 







L 102 


2if00 




PSN 





1 


L 103 


6100 0100 


• 


f IM 
• 


PP^,CH 
• 


1 
1 


L 205 




• 
• 

PPRA 


• 
• 

BSS 


• 
• 




1 
i 


L 






IOC 





j 


L 


0100 




CON 


PPR 




L 1 


Oilk 




CON 


STM 


i 


L 2 


0121 




CON 


OPH 


i 


L 7 


0132 




CON 


EXR 




L it 


0136 




CON 


CHS 


i 


L 5 


Qlk7 




CON 


OMP 


1 


L 6 






CON 


END 




L 7 


1000 


• 


CON 
• 


lOOQ 
• 


1 
1 


L 215 




• 

• 


• 
• 


• 
• 


1 






LOC 


••O-RES+PPR 




L 215 






BSS 






L 2ifO 




END 


BSS 




1 


7ZkQ 






LOC 


»0 


1 
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4.5.6 POS - SET POSITION COUNTER 



The POS pseudo instruction sets the value of the position counter for the block in use to the value 
specified by the expression in the variable field. 

Format: 



lOCATION 


OPERATION 


VARIABIE SUBflElDS 




POS 


aexp 



An absolute evaluatable expression having a positive value less than or 
equal to the assembly word size (60 for CPU, 12 for PPU). A negative value, or 
a value greater than 60 (or 12), causes an error. The value indicates the bit 
position within the current word at which the assembler is to assemble the next 
code generated. Use caution, because if the new position counter value is greater 
than the old position counter value, part of the word is reassembled. (New code 
is ORed with previously assembled data. ) If the new position counter value is less 
than the old position counter value, the assembler generates zero bits to the 
specified bit position. If the value of aexp is zero, COMPASS assembles the next 
code in the following word. 

A location field symbol, if present, is ignored. 

NOTE 

If the POS instruction is used on a word containing relocatable or external 
addresses, undefined results can occur with no diagnostics. 

The POS instruction does not alter the origin and location counters. The position counter is never 
at the beginning of an instruction. At the beginning of a new operation, ira data value has been ' 
stored into bit (the rightmost bit) of a word, COMPASS increments the origin counter and the 
location counter and resets the position counter to 60 (or 12). 

A POS *P has no effect whereas a POS $ subtracts one from the counter. 



4.6 SYMBOL DEFINITION 

The pseudo instructions EQU, =, SET, MAX, MIN, and MICCNT permit direct assignment of 21 -bit 
values to symbols. The values can be absolute, relocatable, or external. Register designators are 
not valid in the expressions. Subsequent use of the symbol in an expression produces the same result 
as if the value had been used as a constant. In the listing of the symbolic reference table, a refer- 
ence to an EQU, =, SET, MAX, MIN, or MICCNT instruction is flagged with a D. Symbols defined 
using EQU and = cannot be redefined; symbols defined using any of the other symbol definition 
instructions can be redefined. 
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4.6.1 EQU OR EQUATE SYMBOL VALUE 



An EQU or = pseudo instruction permanently defines the symbol in the location field as having the value 
and attributes indicated by the expression in the variable field. 

Formats: 



lOCATION 


OPERATION 


VARIABLE SU8FIEIDS 


sym 


EQU 


exp 


sym 




exp 



sym A location symbol is required. See section 2. 4 for symbol requirements. 

exp An evaluatable expression. Any symbols in the expression must be previously 

defined or declared as external. The expression cannot contain symbols 
prefixed by =S, =X, or =Y unless the symbols liave also been defined conven- 
tionally. If the expression is erroneous, COMPASS does not define the location 
symbol but flags an error. 



Examples: 







LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




n 


18 l30 






OPS 




20^378 




7k 




LINP 








3 




CH 


EQU 


3 




7k 




PAGESIZ 




LINP 




bkZ71 




LGOPS 


EQJ 


♦-OPS 





4.6.2 SET ~ SET OR RESET SYMBOL VALUE 

A SET pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the expression in the variable field. A subsequent SET using the same symbol redefines 
the symbol to the new value and attributes. SET can be used to redefine symbols defined by SET, MAX, 
MIN, or MICCNT, only. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIOS 


sym 


SET 


exp 
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sym A location symbol is required. See section 2.4 for symbol requiremeats. 

exp An evaluatable expression. The expression cannot include symbols as yet und 

and cannot contain symbols prefixed by =S, =X, or=Y, unless the symbols ar 
also defined cottventlonally. 

If the expression is erroneous, COMPASS does not define the symbol but 
issues a warning flag. '1 

rim symbol in the location field cannot be referred to prior to its first definition. 
EsEsamples : 





LOCATION 


0?E«ATION 


VAjtlABlE 


COMMENTS 










j30 - • 'S: 


17 


A 


EQU 


15 


.„^_._4. _ ■ — — 

1 A HAS VALUE OF 15 


7k 


B 


SET 




j B HAS VALUE OF POSITION COUNTER 


22 


C 


SET 




jc HAS VALUE A*3 OR ifi 


76 


B 




B*2 


1 ILLEGAL, B IS DOUBLY DEFINED 


2** 


C 


SET 


C+2 


j LEGAL, C CHANGES FROM 18 TO 20 




D 


SET 


F*A 


J ILLEGAL, F AS YET UNDEFINED 






ess 


AA 


(ILLEGAL, REFERENCE PRECEDES 










jFIPS? DEFINITION 


20 


AA 


SET 


16 





4.6.3 AM^X- SET SYMBOL TO MAXIMUM VALUE 

Tlie MAX pseudo instruction defines the symbol in the location field as having the value and attribut€ 
indicated by the largest (most positive) value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MAX can be used to redefine symbols defined by these instructions. 



F«srmat: 



sym 



exp. 



LOCATION 


OPEHAIION 


VARIABLE SUSFIEIOS 


sym 


MAX 


expj^,exp2...« »exp^ 



A location field symbol is required. See section 2. 4 for symbol requiremei 

An evaluatable expression. Any symbols in the expression must be previou 
defined. The e:g)ression cannot contain symbols prefixed by =S, or =X, or 
unless the symbols are also defined conventionally. 



4-40 



60492 



The expressions should have similar attributes. No test is made for attributes. The test for maximum 
value is made in pass one. In testing for the maximum value in pass one, COMPASS uses values for 
relocatable symbols relative to block origins. 



NOTE 



During pass two, the expression selected in pass one is 
used. The relocatable ssonbols have been reassigned 
values relative to program origin and these values are 
used for the final value of the expression selected in the 
first pass. 

If any of the expressions are erroneous, COMPASS does not define the symbol but issues a warning flag. 
The symbol in the location field cannot be referred to prior to its first definition. 



Example: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




n 


18 l30 




PT3 


EQU 


5 


! ^ ■ 






PT31 


EQU 


6 








PT32 


EQU 


2 








SYM 


HAX 


PT3,PT3i 


,PT3E 

1 





4.6.4 MIN - SET SYMBOL TO MINIMUM VALUE 

A MIN pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the minimum or least positive value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MIN can be used to redefine symbols defined by these instructions. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sjrm 


MIN 


expj^.expgf . . . ,expjj 



sym 
exp. 



A location symbol is required (section 2.4). 

An evaluatable expression. Any symbols in the expression must be previously 
defined. The expression cannot contain symbols prefixed by -S, -X, or -Y, 
unless . the symbols are also defined conventLonally. 



The expressions should have similar attributes; no test is made for attributes. 

The test for minimum value is made in pass one. hi testing for the minimum value in pass one. 
COMPASS uses values for relocatable symbols relative to block origins. 
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NOTE 



Durii^ pass two, the expression selected in pass one is 
used. The relocateble symbols have been reassigned 
values relative to program origin and it is these values 
that are used for the final value of the expression which 
was selected in the first pass. 

If any of the e^qjressions are erroneous, COMPASS does not define the s5rmbol but issues a warning 
flag. 

The symbol in the location field cannot be referred to prior to its first definition. 
4.6.5 MICCNT - SET SYMBOL TO MICRO SIZE 

The MICCNT pseudo instruction defines the symbol in the location field as having a value equal to the 
number of characters in the value of the micro named in the variable field. A subsequent SET, 3VLAX, 
MIN, or MICCNT using the same sjntnbol redefines the symbol to the new value. Conversely, MICCNT 
can be used to redefine symbols defined by these instructicaas. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUSFtElDS 


sym 


MICCNT 


mname 



sym A location symbol is required (Section 2.4). 



mname Name of a previously defined micro; it may be a system micro or may have 

been defined through MICRO, OCTMIC, DECMIC, or BASE. If mname has 
not been previously defined, the location symbol is not defined (or redefined) 
and a warning flag is issued. 

Example: 







LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 ho 














HSG 


MICRO 
• 


It , ♦STRING* 


iOEFINE 6 -CHARACTER MICRO 

h 


6 




MSIZE 


• 

• 

MICCNT 
• 


• 

MSG 
• 


I' 
• 

'MSIZE EQUALS 6 
1. 






KSG 


• 
• 

MICRO 


• 
• 

1, ,»ALPHftNU1 


I. 
!• 

iERIC .#HSG;^* 19 CHAR, MICRO 






MSG 


MICRO 


lt,»ALPHANU} 


^ERIC STRING* 19 CHAR, MICRO 


23 




MSIZE 


MICCNT 


MSG 


ImSIZE EQUALS 19 
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4.6.6 SST - SYSTEM SYMBOL TABLE 



An SST pseudo instruction defines system symbols, with the exception of the symbols noted, as if the 
symbols had been defined in the sulprogram. 

When a system text overlay is used as input to an assembly through the G or S option on a COMPASS 
control card, all micros and opcodes in the system text overlay are defined automatically at the start 
of each assembly; however, the symbols in the system text overlay are defined only for assemblies 
that contain the SST pseudo instruction. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIOS 




SST 


symj,sym2,...,sym^ 



sym^ One or more symbols on the file that are not to be defined. 

A location field symbol. If present, is ignored. 
Refer to section 10. 2 for an example of SST use. 



4.7 SUBPROGRAM LINKAGE 

Pseudo instructions ENTRY, ENTRYC, and EXT do not define symbols but either declare symbols 
defined within the subprogram as being available out-^ide the subprogram or declare symbols referred 
to in the subprogram as being defined outside the sui^program. 



4.7.1 ENTRY AND ENTRYC - DECLARE ENTRY SYMBOLS 

The ENTRY pseudo instruction specifies which ol f i e symbolic addresses defined in the subprogram 
can be referred toby subprograms compiled or assembled independently; ENTRY lists entry points to 
the current subprogram, ENTRY is illegal in PPr assemblies. 

The ENTRYC t pseudo instruction conditionally specifies which of the sjnnbolic addresses defined in 
the subprogram can be referred to by subprograms compiled or assembled independently; ENTRYC 
lists conditional entry points to the current subpro.;ram. ENTRYC is illegal in PPU assemblies and 
is synonymous with ENTRY in absolute CPU assemblies. In a relocatable assembly, an entry point 
symbol declared by ENTRYC is ignored by the linking loader if the value of the symbol is relative to a 
common block and that common block was first declared by a previously loaded subprogram. 



tNot supported by SCOPE 2 Loader, 
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Formats: 



lOCATION 


OPERATION 


VARIABLE SUBflELDS 




ENTRY 


syin^,syin2,...,syin^ 




ENTRYC 


syin^,syin2,...,sym^ 



synij Linkage symbol; 1-7 characters of which the first must be alphabetic (A-Z) and the 

last must not be a colon. The symbol cannot include the following characters: 

+ - * / blank , or A 

Each symbol must be defined In the subprogram as nonexternal {cannot begin with 
=X or =Y or be listed on an EXT pseudo instruction). Entry point symbols must be 
unqualified (section 2.4.5). 

A location symbol, if present, is ignored. 

A list of all entry points declared in the subprogram precedes the assembly listing. An asterisk 
appears to the right of each conditional entry point. 



Example: 



Location Code Generated 


LOCATION 


OPERATION 


VARIABLE COMMENTS 






II 


18 |30 














IDE NT 


CT, CONTROL, cjoNTROL 






ftBS 








ENTRY 


HOOE 1 






ENTRY 


ONSW 1 






ENTRY 


OFFSN 1 






ENTRY 


ROLLOUT 1 






ENTRY 


SETPR , 






ENTRY 


SETTL 1 






ENTRY 


SWITCH 1 


lit! 




ORG 


lion 


110 


:ONTROi 


BSS 


i 


110 5120000100 


WOE 


SA2 


ACTR 1 


73720 




SX7 


X2 


111 5110000002 




SAl 


2 1 






• 


1 






• 


1 






• 


t 
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4.7.2 EXT - DECLARE EXTERNAL SYMBOLS 

The EXT pseudo instruction lists symbols that are defined as entry points in independently compiled or 
assembled subprograms for which references can appear in the subprogram being assembled. The 
EXT pseudo instruction is illegal in an absolute subprogram. In a relocatable subprogram, EXT 
defines symbols as strong externals (section 2.4. 1). 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




EXT 


syinj^,sym2,...,sym^ 



symj Linkage symbol, 1-7 characters of which the first must be alphabetic (A-Z) and the 

last must not be a colon. The symbol cannot Include the following characters; 

+ - * / blank , or a 



These symbols must not be defined within the subprogram. External symbols 
are unqualified. 



A location field symbol, if present, is ignored. 

An external reference is flagged with an X in the address field in the listing of code generated. All 
external symbols are listed in the header information for the assembly listing. 



4.8 DATA GEMERATIOM 



The instructions described in this section are the only pseudo instructions that generate data. All 
other program data is generated through symbolic machine instructions. An instruction that 
generates data cannot be used in a blank common block. The pseudo instructions that generate data 
are: 



BSSZ 

blank operation field 

DATA 

DIS 

LIT 

VFD 

CON 

R= 

REP, REPC, or REPI 



Generates zeroed words 

Generates one zeroed word 

Generates one or more words of data 

Generates one or more words of data 

Generates literals block entries 

Places expression values in user-defined fields 

Places expression values in full words 

For use in macros; R= assumes that either (Bl)=l or (B7)=l and 
generates increment instructions accordingly 

Does not actually generate object code at assembly time but 
causes the relocatable loader to repeatedly load a sequence of 
code into a reserved blank storage area. 
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4.8.1 BSSZ AND BLANK OPERATiON FIELD— RESERVE ZEROED STORAGE 



The BSSZ instruction reserves zeroed core in the block in use. The origin and location counters are 
adjusted by the requested number of words and the assembler generates data words of zero to be 
loaded into the reserved area. An instruction that contains a symbol in the location field but has a 
blank operation field has the same effect as a BSSZ of one word. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


BSSZ 


aexp 



sym If present, sym is defined as the value of the location counter after the force 

upper occurs. The symbol identifies the beginning of the reserved storage area. 

aexp^ Absolute evaluatable expression specifying the number of zeroed words of 

storage to be reserved. The expression cannot contain external symbols or 
result in a relocatable or negative value. , 

A BSSZ or an erroneous expression causes a force upper and symbol definition but no storage is 
reserved. 

A BSSZ or group of BSSZ instructions of six or more words produces an REPL table in object code to 
reduce the physical size of the object program (appendix B). 

For a blank operation field the listing shows one zero word of data; for a BSSZ instruction the listing 
shows the word count. 

4.8.2 DATA - GENERATE DATA WORDS 

The DATA pseudo instruction generates one or more complete 60-bit or 12-bit data words in the 
current block for each item listed in the variable field. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DATA 


itemj^,item2,. 


...itenijj 



sym If present, sym is assigned the value of the current location counter after 

the force upper occurs. It becomes the symbolic address of the first item 
listed. 
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item. Character, octal numeric, or decimal numeric data item, according to 

specifications described in section 2. 7. Floating point notation is illegal in 
PPU assemblies. Items are separated by commas and terminated by a blank. 
A literal cannot be used as an item. 

A DATA pseudo instruction always forces upper. A blank item does not cause generation of a data word. 

Unless the D list option is selected, only item.^^ appears on the listing. 

Examples : 



Location 



Code Generated 



552 1C»0717Q0000300000 00 

553 VOOOnOOOOOOQOCOOOOQO 
S5k 03171520111£fr05QOOQQQ 

555 17252<*20252t»Qt]000 013 

556 OOOOOOOQQOOQOOQOOOOO 

557 17205i«*631«*631i*631i*6 
5&Q 16'f03i«»631«*&31i*631«*6 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 




OPTB 


DATA 


QLLGO t 




OPT 


DATA 


iBS59 ' 




OPTT 


DATA 


OLCOMPILE ' 




OPTO 


DATA 


0LOUTPUT,0 1 

1 




OPTY 


DATA 


1.3EE 1 



Location 



Code Generated 



1250 
1251 
1252 
1253 
125«* 
1255 
1256 
1257 
1260 
1261 
1262 



7070 
7770 
0000 
003«* 
5501 
0000 
0506 
0123 
7773 
0<*01 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 






PERIPH 








BASE 


' 






» 


• 1 






• 


• 


1 


)AT 


DATA 


7070,-7,0, IPi 






DATA 


2C A,OLEF 






DATA 


3123, -i* j 






DATA 


H»OATA» 1 



4.8.3 DIS— GENERATE WORDS OF CHARACTER DATA 



The DIS pseudo instruction generates words containing character data. The instruction can be used 
conveniently when a character data string is to be used repeatedly. Unless the D list option is selected 
only the first word of character data appears on the listing. The instruction has two formats: 
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Format one: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DIS 


n, string 



sym If present, sym is assigned the location counter value after the force upper 

occurs. It is the symbolic address of the first word containing the character 
string. 

n An absolute evaluatable expression specifying an integer number of words to be 

generated. When base is M, COMPASS assumes that n is decimal. 

string Character string 

For a CPU program, COMPASS takes 10 times n characters from the string and packs them as they occur 
10 characters per word into n words. For a PPU program, COMPASS takes two times n characters from 
the string and packs them as they occur two characters per word into n words. If the statement ends 
before 10 x n (or 2 x n) characters, the remainder of the requested words are filled with blanks. 
If n is 0, COMPASS assumes the instruction is in format two. 

Format two: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DIS 


jdstringd 



sym If present, sym is assigned the location counter value after the force upper 

occurs. It is the symbolic address of the first word containing the character 
string. 

d Delimiting character 

string Character string; any character other than delimiting character 

In this form, the string must be bounded by delimiters. The comma is required. The characters between 
the two delimiting characters are packed into as many CPU or PPU words as are needed to contain them. 
Twelve zero bits are guaranteed at the end of the character string even if COMPASS must generate an 
additional word for them. If COMPASS detects the end of the statement before it detects a second 
delimiting character, it produces a fatal error. 
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Examples : 



Location Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


561 0705160522012^055535 

562 5503202555271 7220 «»23 

563 0705160522012^*055535 
Sbk 550321I25552717220%23 
565 OtJOOQOOOOO0tlQQ8QQO0Q 






11 


18 i30 




ONE 

TMO 


OIS 
OIS 


2, GENERATE ?l CPU WORDS 
! 

,»GENERATE 2| CPU WORDS* 

1 
1 



Location 



Code Generated 



1<*02 


Q705 


1«»03 


1605 




2201 


l<fr05 


2^+05 


1**06 


5BZk 


1<*07 


3355 


1«»1Q 


2020 


I'tll 


5527 


IkiZ 


1722 


i<»13 


0^23 


Iklt* 


0705 


IklS 


1605 


1«»16 


2201 


lkl7 


2^*05 




553** 




3355 


ltf22 


2020 


lit23 


5527 




1722 


IkZS 


0'*23 




0000 



LOCATION 



OPERATION 



FPJ 

BASE 
Ulii 



DIS 



VARIABLE 



COMMENTS 



130 



M 

10, GENERATE 



, ♦GENERATE 1 



la PP WORUii 



r>P WORDS^ 



4.8.4 LIT - DECLARE LITERAL VALUES 

A LIT pseudo instruction generates data words in the literals block. This instruction and the 
= prefix to a data item provide the only means of generating data in the literals block. The LIT 
pseudo instruction assures sequential entries for a table of values. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBflELDS 


sym 


LIT 


itemj^ , itemg , . . • , item^ 
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sym 



If present, sym is assigned the value of the literals block location counter. 



item. At least one and not more than 100 words of character, octal numeric, or 

decimal numeric data items. Section 2.7.3 contains specifications. Items 
are separated by commas and terminated by a blank. Floating point data 
items are illegal in PPU assemblies. 



COMPASS enters data items into the literals block in the order specified. 

If the converted binary values for all the data items listed with a single LIT match an existing literal 
block sequence, they are not duplicated. If, however, any item in the list does not match an entry in 
the block, the entire sequence is generated. A literal item subsequently referred to through an 
= prefix is not duplicated. A null item (e.g. H** or OL) does not cause a word to be generated. 

Examples: 



Location Code Generated 



000611 
000612 
000613 
00061% 
000615 



611 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 i30 












POOL 


LIT 




,2. 7162182,57.2 95 7795EE1 



CONIFNT CF LITERALS BLCCK, 



172161«»631if631«»631it6 

172 06275576if<»l 776271 
1721533 7351 1360 li»«»26 

173 Hf 363651 1»<»0 663 121 
1651333303351*0 576566 



oor-Y-Y-v- 

0Q?s»?IlA9V 
0Y8»K>L5vYQ 
N{00C25,r»v 



Location Code Generated 



7U56 

CONTENT CF LITFRfiLS BLOCK. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


J 




11 


18 |30 












N2 


LIT 
LIT 
LIT 


iRl,7070 ,7s(J 
2C A,QLEF 1 
H»LITERALS' 1 



7hh7 


0Q3<» 


1 


7h5fi 


7070 




7hSi 


0007 


G 


7h5Z 


0000 




7«»53 


5501 


A 


7h5h 


0000 




7hS5 


0506 


EF 


7%56 


li»ll 


LI 


7%57 


2405 


TE 


7ai60 


2201 


RA 


7l»61 


1%23 


LS 
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4.8.5 VFD - VARIABLE FIELD DEFINITION 

The VFD instruction generates data in the current block by placing the value of an expression into a 
field of the specified size. 

Format: 



lOCATlON 


OPERATION 


VARIABLE SUBFiElOS 


sym 


VFD 


itemj^/e3q)j,item2/eJ^2»" • »^^^/®^n 



sym For a CPU assembly, the location field can contain S3rm, plus, minus, or 

blank, as follows: 

sym If a symbol is provided in the location field, a force upper occurs 

and the value of the location counter following the force upper is 
assigned to the sjnnbol. The symbol identifies the first word of 
data generated by the VFD. 

+ Causes a force upper. Data generation begins in a new word. 

COMPASS generates zero bits to the next quarter word boundary, 
at which point the first field begins. 

blank COMPASS begins the first field at the current value of the position 

counter. 

For a PPU assembly, if the location field contains a plus, minus, or a symbol, 
data generation begins in a new word. If the location field is blank, the first 
field begins at the current value of the position counter. 

item An unsigned constant or previously defined symbol having a value specifying a 

^ positive integer number of bits for the field to be generated; maximum field 

size is 60 bits for both CPU and PPU assemblies (60 beii^ the maximum 
nxmiber of significant bits for an expression value). When base is M, item, 
is assumed to be decimal notation. 

exp| An absolute, relocatable, or external expression, the value of which will be 

inserted into the field specified by itemi. The expression is evaluated using 
the specified field size. Character constants are right or left justified in the 
field according to the type of justification indicated. In a relocatable CPU 
assembly, no field that contains a relocatable or external address expression 
can cross a 60-bit word boundary, and no 60-bit word can have more than 
four fields that contain relocatable or external address expressions. 



Each field is generated as it occurs. For a CPU assembly, if the next instruction that generates code 
in the block is not a VFD with a blank location field, and the last VFD field in the current VFD ends to 
the left of a quarter word boundary, COMPASS inserts zero bits up to the next quarter word boundary. 
These zero bits do not show on the assembly listing. Remaining parcels are then filled with no- 
operation instructions. 
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When a VFD instruction that does not have a location field entry immediately follows another VFD In the 
same block, no padding with zeros or forcing upper occurs; fields are generated sequentially as they are 
specified. 

Following a VFD, the position counter contains the numl^r of bits remaining to be assembled in the last 
word in which data was generated by the VFD. 

Examples.: 

In the first example, the symbol TABLOC has been defined earlier in the program and associated with 
000551. 



Location 


Code Generated 




lOCATlON 


OPERATION 


VARIABLE COMMENTS 






1 




n 


18 bo 




31 




ALPHA 


SET 


1 

25 1 


566 2«*Oi02000Q0023000551 




TABLE 


VFO 


36/3CTAB,6/l^, 18/TABLOC 


567 0000(3005665555555555 






VFO 


30/*-l ,30/5H , ALPHA/-0 


570 777777711^ 








1 




OOOOQOQOOOflO 






VFO 


*P/ 1 


571 Iil72it01550155555531 






VFO 


30/0HIOTA,6/lRA,2i»/0AX-»-l 


572 000000150523230107Q5 






VFD 


60/0RMESSAGE,3 0/3tCIO,15/0R0 


573 031117000000033 








1 


Location 


Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 






1 




11 


18 |30 










PPU 












BASE 


H 1 


1310 


333% 






VFD 


60/10R0123ft56789 


1311 


3536 










1312 


37i»0 










1313 












1311* 












1315 


OOIQ 




All 


VFO 


12/10,12/11, 12/-12,12/-7070 


1316 


0011 










1317 


7765 










1320 


07 07 











4.8.6 CON - GENERATE CONSTANTS 

The CON pseudo instruction generates one or more Ml words of binary data in the block in use. It 
differs from DATA in that it generates expression values rather than data items and differs from VFD 
in that the field size is fixed. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


CON 


exp^,exp2,...,exp^ 



sym If present, sym is assigned the value of the location counter after the force 

upper occurs. 

exp. An absolute, relocatable, or external expression the value of which will be 

^ inserted into a field having a size of one word. For PPU assembly, floating 

point is not allowed; for CPU assembly, double precision is not allowed. 
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Examples: 

la the first example, the symbols FAIL and PASS have been defined earlier in the program and associated 
with 2204 and 2172, respectively. 



Location 


Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






1 




11 


18 130 


1460 


0000 




MSQl 


CON 







1461 


0006 






CON 




1 


1462 


0003 






CON 


3 




H63 


2204 






CON 


FAIL 




1464 


0024 






CON 


20 




146S 


0000 




MS62 


CON 







t ^ ^ 
X w o 


V/ w V/ O 






CON 


6 


1 
1 


1467 


0003 






CON 


3 




1470 


2172 






CON 


PASS 


1 


1471 


0024 






CON 


20 


1 


Location 


Code Generated 




LOCA 1 lON 


L/r CK A f \\Jr< 


VARIABLE 


COMMENTS 








1 






18 


|30 








TAO 


BSS' 




i 


L 








LOG 







L 


0OO0O0 0OQQBBQ00Q55 






€0N 


IR 


iQO 


I 1 


000 00 000 00 000 62 






CON 


IR] 


,01 


L 2 


OOOOO0OO00OO0Q00O06«* 






CON 


IR:^ 


'02 


L 3 


0O00O0QO00O00000Q060 






CON 
• 


iR= 
• 


l03 
1 • 


L 75 


OO0QO00QO0OQ00QQO066 






■ 
• 

CON 


• 

• 

IRv 


1 * 
1 75 


L 76 


OOOOOQOOOOQOQQ000076 






CON 


IR"' 


j 76 


t 77 


00000000000000000055 






CON 


IR 


77 


67«t 








LOC 


^0 





4.8.7 R = - CONDITIONAL INCREMENT INSTRUCTION 



The R= pseudo instruction generates a CPU increment unit instruction depending on the contents of the 
variable subfields and on whether or not the subprogram earlier contained a Bl=l or B7=l pseudo 
instruction (section 4.4.4). 

Use of R= augments macro definitions and increases optimization of object code. It is illegal in a 
PPU program. 

The A list option controls listing of substituted instructions. 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 




reg.exp 



Optional, if present, sym is assigned the value of the location counter after 
the force upper occurs. This force upper occurs whether the R= generates an 
instruction or not. 
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reg A register designator (A, X, or B) and a agit (0-7) which COMPASS 

concatenates with S to form the instruction operation code. 

exp Operand register or value expression. If exp is the same two characters 

as reg, no instruction is generated. 

If the expression value is 0, the variable field is BO. 

If the Bl=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the variable field of the instruction is Bl, 
Bl+Bl, or -Bl, respectively. 

If the B7=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the variable field for the instruction is B7, 
B7+B7, or -B7, respectively. 

In all other cases, the variable field is the register or value indicated by the 
expression. 

Examples: 

1. R= used with Bl=l 



Code Generated 






LOCATION 


OPERATION 


VARIABLE 


COMMENTS 










11 


18 iao 




iilllii • 






Bl-1 
R= 


i 

B3,? 1 

83,3 

3 1 



2. R= used with BIt^I 



Code Generated 



liiiiiliii: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




n 


18 






TAG . 




X5,-l 
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3. Expression is same as register designator: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




n 


18 130 




RFG 


HICRO 
R= 


1, ,'-B5» 1 

nSftREGt ; 



No instruction is generated; SB5 m would be a no operation instruction. 
4.8.8 REP, REPC, AND REFI - GENERATE LOADER REPLICATION TABLE 

The REP, REPC, and REPI instructions cause the assembler to generate an REPL loader table so 
that when the subprogram being assembled is loaded, the loader will load one or more copies of a 
data sequence. For the REPI instruction, the loader generates the copies immediately upon encoun- 
tering the table; for REP, the replication takes place at the end of loading. For REPC the loader 
ignores the REPL table if the destination data address is in a common block that was first declared 
by a previously loaded subprogram; otherwise, the loader generates the copies immediately upon 
encountering the tables. 

Replication of object code is valid in relocatable assemblies only. It is particularly useful for setting 
one or more blocks of storage to a given series of values or for generating tables. 

Data to be replicated must not contain any external references or common block relocatable addresses. 
For REPC and REPI, data must be in previously assembled text. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




REP 


S/saddr, D/daddr, C/rep, BA>sz, I/inc 




REPCt 




REPI 





A location field symbol, if present, is ignored. 
The variable field subfields can be in any order. 
S/saddr 



D/daddr 



Relocatable expression specifying first word address of code to be copied. 
The S/saddr subfield must be provided. If it is zero, or omitted, the assembler 
flags the instruction as erroneous and does not generate an REPL loader table. 

Relocatable e2q)ression specifying the destination of the first word of the first 
copy. If D/daddr is omitted, the assembler sets daddr to zero, and, when 
daddr is zero, the loader uses saddr plus bsz for the destination address. 

Note that room for the repeated data must be reserved in the destination block. 



+ Not supported by SCOPE 2 Loader. 
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C/rep Absolute expression specifying the number of times code is to be copied. When 

base is M, COMPASS assumes that rep is a decimal value. If C/rep is 
omitted, the assembler sets rep to zero. When rep is zero or one, the loader 
makes one copy. 

BA)sz Absolute expression specifying the number of words to be copied (block size). 

When base is M, COMPASS assumes that bsz is decimal. 

If BA)sz is omitted, the assembler sets bsz to zero. When bsz is zero or one, 
the loader copies one word. 

I/inc Absolute expression specifying the increment size in words. When base is M, 

COMPASS assumes that inc is in decimal. 

The increment size is the mmiber of words between the first word of each copy. 
When inc is zero or omitted, the loader uses bsz as the increment size. The 
loader writes the first copy starting at daddr, the second starting at daddr+inc, 
the third at daddr + 2 x inc, etc. until the rep count is exhausted. 

The origin and location counters for the block containing the daddr are not advanced by a value of 
inc X rep. Storage reservation for replicated code is the responsibility of the user. 



Rules for replication: 

1. The S subfield cannot be omitted 

2. Room must be reserved for the copies in the destination block ^for example, through 
ORG, ORGC, or BBS) 

3. REP, RE PC, and RE PI can be used in relocatable assemblies only 

4. Data t6 be replicated must not contain any external references or common block relocatable 
addresses 

5. For REPC and REPI, data must be in previously loaded text 



Example: 



Location 


Code Generated 




lOCATlON 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 Uo 




10 




PC 




_ 










USE 


NEW" I 


5017 


00000000000000000015 




BP 


DATA 


15,20,7070B, 1,5,3.1^» 




00000000000000000020 








1 


50?1 


00000000000030007070 










•5 022 


OOOOOQOOOOOOOOnOOOOl 








1 


5023 


00000000000000000005 








1 


502tf 


1721630*0000000000000 












13 




I 


EQU 


*-eA+5 j 










USE 


ORLOCK 1 


5251 






OA 


RSS 


RC*T 1 










USE 


♦ ' 












S/BA ,D/0ft,B/I-5,C/RC,I/I 
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4.9 COHDITrOMAl ASSEMBLY 

The following pseudo instructions permit optional assembly or skipping of source code. A special 
SKIP, causes unconditional skipping. COMPASS provides IF test instructions that: 



Test for assembly environment (IFtype) 

Compare values of two expressions (IFop) 

Compare values of two character strings (IFC) 

Test the attribute of a single symbol or an expression (IF) 

Test the sign of an expression (IFPL and IFMI) 



Immediately following the test instruction are instructions that are assembled when the tested condition 
is true and skipped when the condition is false. Skipping is terminated either by a source statement 
count on the IF instruction, or by an ENDIF, an ELSE, or an END. 

The statement count, when used, is decremented for instruction lines only; comment lines (identified by 
* in column one) are not counted. Determining the IF range with a statement count produces slightly 
faster assembly than using the ENDIF. 

The results of an IF test are determined by the values of expressions in pass one; the value of a 
relocatable symbol is relative to the USE block in which it was defined. The value of an external symbol 
Is if the symbol was declared as external. If the symbol was defined relative to a declared external, 
the value is the relative value. 



4.9.1 ENDIF - END OF IF RANGE 

An ENDIF causes skipping to terminate and assembly to resume. When the sequence containing the 
ENDIF is being assembled, or is controlled by a statement count, the ENDIF has no effect other than 
to be included in the count. 

Skipped instructions such as macro references are not expanded. Thus, any ENDIF that would have 
resulted from an expansion is not detected. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


ifaame 


ENDIF 





Ifname 



Name of an IF, SKIP, or ELSE sequence; or blank, ifname can be used as any 
other type of symbol elsewhere in the program. 
Skipping of a sequence initiated by an IF, SKIP, or ELSE that is assigned a name can be terminated 
by an ENDIF specifying the sequence by name, or by any unnamed ENDIF. Any ENDIF terminates 
skipping of an unnamed sequence that is not controlled by a source line count. A named ENDIi 
terminates the named IF, SKIP, or ELSE and any unnamed IF, SKIP, or ELSE sequences in effect 
that are not under line count control. 
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4.9.2 ELSE - REVERSE EFFECTS OF IF 



Through the ELSE instruction, COMPASS provides the facility to reverse the effects of an IF test 
within the IF range. An ELSE detected during skipping causes assembly to resume at the instruction 
following the ELSE. An ELSE detected while a sequence is being assembled initiates skipping of source 
code following the ELSE. Scipping continues until: 

1. A statement count specified on the ELSE is exhausted 

2. A second ELSE is detected for the sequence 

3. An ENDIF is detected for the sequence 
Format: 



lOCATION 


OPERATION 


VASiABlE SU6FIE10S 


ifiiame 


ELSE 


£nct 



Ifname Name of an IF, SKIP, or ELSE sequence, or blank. 

£nct Optional absolute evaluatable expression specifying integer number of source 

lines to be skipped. It has no effect if the ELSE resumes assembly. When the 
base is M, COMPASS assumes that fnct is decimal. 

An ELSE specifying the sequence by name or any unnamed ELSE terminates skipping of a sequence 
initiated by an IF, SKIP, or an ELSE that has an assigned name. Skipped instructions such as macro 
references are not expanded; any ELSE that would have resulted from the expansion is not detected. 



4.9.3 IFTYPE - TEST OBJECT PROCESSOR TYPE 

IFtype pseudo instructions test for the type of processor that will execute the object program, as 
declared by MACHINE, and PERIPH or PPU pseudo instructions. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




IFtype 


£nct 
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ifiiame 



Optional 1-8 character name. 



type Mnemonic specifying type of object processor. 

Type Condition Causing Assembly 

CP Any central processor unit 

CPS Neither PERIPH nor PPU nor MACHINE 7 has been specified, 

CPU code Is assembled for a CYBER 170 Series, CYBER 70/ 
Model 71, 72, 73, or 74 or 6000 Series Computer System. 



CP7 Neither PERIPH nor PPU nor MACHINE 6 has been specified. 

That is, CPU code is assembled for a CYBER 70/Model 76 
or a 7600 Computer System. 

PP Any peripheral processor unit 



PP6 One of the following is true: 

1. PERIPH has been specified but MACHINE 7 has not 
been specified. 

2, PPU and MACHINE 6 have both been specified. PPU 
code is assembled for a CYBER 170 Series, CYBER 
70/Model 71, 72, 73, or 74 or a 6000 Series Computer 
System, 

PP7 One of the following is true: 

1. PPU has been specified but MACHINE 6 has not 
been specified, 

2, PERIPH and IMACHINE 7 have both been specified. 
That is, PPU code is assembled for a CYBER 70/ 
Model 76 or a 7600 Computer System. 



£nct Optional absolute evaluatable expression specifying an Integer count of the 

number of statements to be skipped. When base Is M, COMPASS assumes 
that fnct Is decimal. 

The ifname and j&act parameters are related as follows: 

1. If a count Is supplied. It takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF In a count controlled sequence Is to be Included In the count. Skipping 
terminates when the count Is exhausted or when an ELSE with a matching or blank name Is 
encountered, whichever occurs first. 

2. If neither a count nor a name Is supplied, the IF range Is terminated by an ENDIF, whether 
named or imnamed, or by an unnamed ELSE, whichever Is encountered first. A named ELSE 
has no effect. 
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3. 



If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 



Example: 



Code Generated 



173 0130000000 



lOCATION 



OPERATION 



IHENT XYZ 
MACHINE 6 



VARIA81E 



• 








BSS 


123 


IFCP6 


2 


XJ 





ELSE 


1 


MJ 






COMMENTS 



130 



4.9.4 IFOP- COMPARE EXPRESSION VALUES 

An IFop pseudo instruction compares the values of two expressions according to the relational 
mnemonic specified and assembles instructions in the IF range when the comparison is satisfied. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 


ifname 


IFop 


expj.expg.fnct 



ifname Optional 1-8 character name 



op Specifies comparative test: 

22 Condition causing assembly 

EQ Equality, the expressions are equal in all respects. That is, they 

not only have the same numeric value but have the same attributes 
as well. For example, both are names that are common 
relocatable, or absolute, or external, etc. 

NE Inequality, the expressions are not equal in all respects. They 

differ in value or in some attribute. 

GT The first expression is greater in value than the second expression. 

No other attributes are tested. 
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GE The first expression is greater than or equal in value to the second 

expression. No other attributes are tested. 

LT The first expression is less in value than the second expression. 

No other attributes are tested, 

LE The first expression is less than or equal in value to the 

second ejqsression. No other attributes are tested. 
For these tests, positive zero and negative zero are equal. 

An expression. When the value of exp is tested, exp can include only previously- 
defined symbols and tiie result can be absolute, relocatable, or external. If an 
undefined symbol is used, the expression value is set to zero, the IF instruction 
is flagged as erroneous, and assembly continues with the next instruction. 

Optional absolute evaluatable expression specifying an integer count of the 
number of statements to be skipped. When base is M, COMPASS assumes 
that £nct is decimal. When £nct is blank, the comma can be omitted. 

The ifiiame and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect, 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 

Example: 

A demonstration of one use of IF statements in a PPU program: 





LOCATION 


OPERATION 


VARIABIE COMMENTS 


1 




It 


M i30 






IF 


DEF,LOOP 






IFLT 


*-LOOP,^0B 






ZJN 


LOOP 






ELiJE 


2 






NJN 


♦♦3 






LJM 


LOOP 






• 




1 




• 








• 





This code assembles a zero jump to the symbol LpOP if IDOP has been defined witnm 37 words (the 
range of a short jump) prior to the occurrence of this code. Otherwise, the NJN and LJMare assembled. 



exp 



£nct 



60492600A 



4-61 



4.9.5 IFPL AND IFMI -TEST SIGN OF EXPRESSION 



The IFPL and IFMI pseudo instructions test the sign of an expression and assemble instructions in 
the IF range according to whether the sign of the value is plus (PL) or minus (MI). The pseudo 
instructions allow positive zero to be distinguished from negative zero. 

Format: 



lOCATtON 


OPERATION 


VARIABLE SUBFIELDS 


ifname 


IFPL 


expjjtoct 


ifhame 


IFMI 


exp,£nct 


ifname 


Optional 1 


-8 character name 



exp An expression. It can include only previously defined symbols and the result 

can be absolute, relocatable, or external. If an undefined symbol is used, the 
instruction is flagged as erroneous and assembly continues with the next 
instruction. 

fnct Optional absolute expression specifying an integer count of the number of 

statements to be skipped. When base is M, COMPASS assumes that met is 
decimal. When fnct is blank, the comma can be omitted. 

The ifname and jenct parameters are related as follows: 

1. If a coimt is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encovmtered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 

The condition tested for by IFPL is satisfied if the value of exp is greater than or equal to plus zero; 
the condition for IFMI is satisfied if the value of exp is less than or equal to minus zero. 



4-62 



60492600A 



Example: 



The following opdef defines the CPU instruction MXi jk so that the address value is 60 if the expressi 
value is negative zero or a positive non-zero multiple of 60, otherwise it is the address expression 
. value modulo 60. 





LOCATION 


OPERATION 


VASIABIE COMMENTS 


1 




1) 


18 l30 




MXQ 


OPOEF 


RE6,VAL i 






LOCAL 


A 1 




k 


SET 


VAL ( 




A 


set 


A-A/60D*S0o' 






IFPL 


A, 3 i 






IFEQ 


A 9 9 3 1 






IFLE 


VALfOvi 






SKIP 


1 1 




A 


SET 


A«-600 , 






VFO 


6/i»JB,3/8EG,6/A 






ENDM 


1 

1 
1 



Example of call: 



Caie Generated 




LOCATION 


OPERATION j 


VARIABLE COMMENTS 




1 




11 j 


18 i30 


7777713 




t * n n n n 1 


MX6 


-S2 1 


7777713 
10 

if3610 






tFPL 
IPEO 

SKIP 

VFO 
ENDM 


SET t^O On'o 01 - t^n 000 01 / 600*60D 

i-^ooonoitJ 1 

1 4.000001,0,31 

1 ' 

SET t*ooO|n*:'i +6 00 

A/^t3B»■^/6♦5/'^*0 00 aOl 
1 

1 



4.9.6 IF - TEST SYMBOL OR EXPRESSION ATTRIBUTE 

The IF pseudo instruction tests a symbol or an expression for a specific attribute and assembles 
instructions in the IF range if the test is satisfied. 
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Format: 



lOCATION 


OPfRATION 


VARIASIE SUBFIEIDS 


ifQame 


IF 


att,exp,£nct 



ifname 
att 



Optional 1-8 character name 

Specifies attribute test. A minus prefix to the attribute causes assembly on 
the false rather than the true condition. 



att Condition causing assembly 

SET The sjrmbol given in the second subfield was defined by a SET, 

MAX, MIN, or MICCNT 

-SET The symbol given in the second subfield was defined other than 

by a SET, MAX, MIN, or MICCNT 

ABS The expression in the second subfield reduces to a value that is 

not relocatable or external 

-ABS The expression in the second subfield reduces to either a 

relocatable or an external address 

REL The expression in the second subfield reduces to a local or 

common relocatable address 

-REL The ejq)ression in the second subfield does not reduce to a local 

or common relocatable address 

REG The expression in the second subfield contains one or more 

register names 

-REG The expression in the second subfield does not contain a register 

name 

COM The expression in the second subfield reduces to a common re- 

locatable address (any blank or labeled common block) 

-COM The expression in the second subfield is not a common relocatable 

address (any blank or labeled common block) 

EXT The expression in the second subfield contains one or more 

external symbols 

-EXT Hie expression in the second subfield does not contain an 

external s3niibol 

LCM The expression reduces to an LCM address 

-LCM The expression does not reduce to an LCM address 

LOC The expression reduces to a program relocatable address 

-LOC The expression does not reduce to a program relocatable address 
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DEF All the symbols in the expression in the second subfield are 

defined 

-DEF One or more of the symbols in the expression in the second 

subfield is undefined 

MAC The name in the second subfield is an opcode name 

-MAC The name in the second subfield does not contain an opcode name 

MIC The name in the second subfield is a micro 

-MIC The seccaid subfield does not contain a micro name 

SST The second subfield contains a system symbol 

-SST The second subfield does not contain a system symbol 



exp For SET, SST, -SET, and -SST, exp must be a single defined symbol. For 

MIC and -MIC, exp must be a name. For any other test, it is an expression. 
The expression can include symbols as yet undefined if att is DEF, -DEF, REG, 
-REG, EXT, or -EXT only. If an undefined sj.-mbol is used with any other 
attribute, the expression value is set to zero, the instruction is flagged as 
erroneous, and assembly continues with the next instruction. Note that if 
a symbol is never defined conventionally but only by use of =S or =X prefix 
(see section 2.4. 2), COMPASS does not define the symbol until the end of 
the assembly, and IF tests will consider the symbol undefined. 

(Xict Optional absolute evaluatable expression specifying an Integer count of the 

number of statements to be sicipped. When base is M, COMPASS assumes 
that £nct is decimal. When £nct is blank, the comma can be omitted. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the coimt is exhausted or when an ELSE with a matching or blank name is en- 
coimtered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 
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Examples 





lOCATION 


OPERATION 


VARIABLE COMMENTS 






11 


18 ho 






BSS 


20 j 




• 


• 






• 


• 


• 




TEST 


• 

IF 


• 

REL,ABLE*15 




• 


• 


• 




• 


• 






TEST 


• 

ENOIF 
IF 
• 
• 


• 

C0H,0Tft,2 ERRONEOUS, OTA AS YET UNDEFINED 

• 1 

* 1 




OTA 


USE 

8SS 


• 1 

// , 
1 



4.9.7 IFC - COMPARE CHARACTER STRINGS 

The IFC pseudo instruction compares two character strings according to the operator specified 
and assembles instructions in the IF range if the comparison is satisfied. 

Format: 



lOCATION 


OPERATION 


VARIABIE SUBFIELOS 


i&ame 


IFC 


op, dstringjdstring2d, jgnct 



ifname Optional 1-8 character name 



d Delimiting character. Characters between the first and second occurrence of this 

character constitute the first character string; characters between the second and 
third occurrence constitute the second character string. 

op Specifies comparative test: 

S2 Condition causing assembly 

EQ or -N£ stringy has the same value as stringy 
NEor-EQ stringy does not equal stringg 
GT or -LS string is greater than string 
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GE or -LT string- is greater than or equal to string 

LT or -GE stringy is less than string2 

LE or -GT stringy is less than or equal to stringg 

string. Character string. When IFC is within a macro definition, each character string 

^ can be a formal parameter. 

£nct Optional absolute evaluatable expression specifying an integer count of the number 

of statements to be skipped. When base is M, COMPASS assumes that jjnct is 
decimal. When fnct is blank, the comma can be omitted. 

The ifname and £nct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the coimt. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an. unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect 

Each character in string-j^ is compared with the corresponding character in string2 progressing from 
left to right until an inequality is found or both strings are exhausted. WTien one string is shorter than 
the other, it is padded with a character that has a value less than any other character in the string. 

The truth condition is based on the relative magnitudes of the characters in the strings. 

Examples : 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 130 




TESTl 


IFC 


EQ,SaBCSABC$ 


ABC EQUALS A8C 




TEST2 


IFC 


tT,»AB»ABC» 


AB IS L^SS TH^N ABC 




TEST3 


IFC 


GT,XAXX 


A IS GREATER THAN NULL 






IFC 




Z IS LESS THAN 8 



The IFC in the following example checks for an empty parameter string. 
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LOCATION 


OPERATION 


VARIA81E COMMENTS 


1 




U 


18 130 




XX 


MACRO 


P1,P2 ' 




IFC 


EQ,»*P2*,1 ' 




p 


ERR 

• 

• 


• Fl <\G ERROR 

1 

1 






• 

ENOM 


\ 
I 
1 



The following example illustrates a character string terminated incorrectly. When COMPASS reaches 
end of statement without finding a third asterisk, the asterisk omitted following PI causes an error flag. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 






n 


18 ho 






IFC 


EQ,*0D*P1,2$P2 



4.9.8 SKIP - UNCONDITIONALLY SKIP CODE 

The SKIP instruction causes COMPASS to unconditionally skip the instructions in the SKIP range. 
It resembles an IF for which there is no tme condition. 

Format 



LOCATION 


OPERATION 


VARIABLE SU6FIELDS 


ifname 


SKIP 


jenct 



ifname Optional 1-8 character name 

£nct Optional absolute evaluatable expression specifying an integer count of the number 

of statements to be skipped. When base is M, COMPASS assumes that £nct is 
decimal. 

The ifname and £nct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the coimt is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 
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2. If neither a count nor a name is supplied, the SKIP range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the SKIP range is terminated by an ENDIF or ELSE with 
a matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 

4.10 mUOR COHTtOL 

The ERR and ERRxx pseudo instructions described in this section either conditionally or unconditionally 
set an error flag. 

4.10.1 ERR - UNCONDITIONALLY SET ERROR FLAG 

An ERR pseudo instruction produces an assembly error but does not affect other code. Usually, it is 
used in conjunction with a conditional assembly pseudo instruction to force an error into the assembly 
based on an assembly time test. One application is to use a test and ERR to detect illegal macro 
parameters. 

Format: 



LOCATION 


OPERATION 


VARIABLE SU6FIELDS 


flag 


ERR 





flag A single alphanumeric character denoting the error type. The flag is placed 

in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control 
card. If no flag is specified, or the character is not one of those given in 
section 11. 7, COMPASS uses P. 

A variable field entry, if present, is ignored. 

Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




n 


18 |30 




nm 


HACRO 


Pl,P2,P3,Pi»i 






IFEQ 


P1,0 1 




A 


ERR 


1 






• 


• 






• 


1 








1 






ENOM 








• 








• 


• 1 






• 








NNN 


0,A,B,C 1 



60492600C 



4-69 



4.10.2 ERRxx - CONDITIONALLY SET ERROR FLAG 

An ERRxx pseudo instruction produces an assembly error when a condition detected during the second 
pass of the assembler is true. 

Format: 



lOCATlON 


OPERATION 


VARIABLE SUBflELDS 


flag 


ERRxx 


aexp 



flag A single alphanumeric character denoting the error type. The flag is placed 

in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control card. 
If no flag is specified, or the character is not one of those given in section 11. 7, 
COMPASS uses P. 

XX Defines condition under which aexp value is erroneous. 

XX Error Condition 

NG or MI Value of expression is negative 

NZ Value of expression is nonzero 

PL Value of ejcpression is positive 

ZR Value of expression is zero 

aexp Absolute expression. It. cannot contain external symbols or references to blank 

common. The test is made in pass two of the assembler. Relocatable addresses 
are assigned values relative to program origin rather than to the block in which 
they are defined. 

NOTE 

ERRxx is the only conditional instruction for which the 
test is made in pass two. Therefore, this is the only 
pseudo instruction that can be used to determine PPU 
overflow if the PPU program has literals and USE 
blocks. 

Example: 

Test for memory overflow in PPU assembly 



Location 


Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 










n 


IS ho 










PERIPH 
• 


1 

1 


7Mi7 

7^62 






LASTTAG 

R 


• 

8SS 


LASTTA6-7777| 

1 
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4.11 ySTii^G CO^T^OL 

The instructions described in this section permit extensive control of the assembly listing format. 



4.11.1 LIST -SELECT LIST OPTIONS 



The LISTpseudo instruction controls the content and format of the assembler listing. LIST instructions 
are disabled under either of the following conditions: 

When the list parameter (L) on the COMPASS control statement (section 10. 1.2) is zero, or 

When the list aptioa parameter (LO) on the COMPASS ccatrol statement is used and is other 
than LO=0. 

Use of the LIST pseudo instruction is optional. If it is not used in the subprogram, COMPASS list 
output is according to the L and LO parameters on the COMPASS control statement. If the LO parameter 
is omitted or LO=0, the list options are as if L, B, N, and R only are selected and the listing ccntams 
heading information, assembly text, assembler statistics, an error directory (upon occurrence of an 
terror only), and a symbolic reference table. Formats of this output are described in detail in 
chapter 11 and brief summaries are given below. 



Heading information 



Assembly text 



Assembler statistics 

Error directory 
Sjrmbolic reference table 



Program length, origin, and length of each block, entry points 
and external symbols. 

Line, and assembly results of each line assembled (not skipped) 
from the input device (excludes code generated by RMT, DUP, 
ECHO, XTEXT, or a macro or opdef expansion). For data 
generating pseudo instructions DATA, DIS, BSSZ that produce 
more than one word of object code, only the first word is listed. 
For VFD and CON all words of object code are listed. For R=, 
only the pseudo instruction is listed. 

Each occurrence of the LIST instruction is listed. 

Amount of storage used, counts of assembled statements, 
defined symbols, invented symbols, and references to symbols. 

Lists fatal and nonfatal errors and summarizes the causes of each. 

List of all symbols defined in the program according to symbol 
qualifier, if any, followed by an index to every reference to the 
symbol in the listed statements. 



Formats : 



LOCATION 


OPERATION 


VARIABLE SUBFIEIOS 




LIST 


opj,op2,...,op^ 




or 






LIST 


* 
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A location field symbol, If present, Is ignored. 



opj A list option represented by a single letter or a letter prefixed by a minus sign. 

The unpreflxed letter selects the option; tiie prefixed letter cancels the option. 
Options are separated by commas and terminated by a blank. 

A List statements actually assembled 

When A is not selected, a line containing concatenation and micro substi- 
tution marks is listed with the marks In It exactly as presented to the 
assembler. When the A cptlon Is selected, however, the assembler lists 
the line before and after the editing takes place. Selecting A also causes 
the listing of lines of code resulting from the R= pseudo Instruction. 

B List binary control statements 

When B is selected, the listing includes SEG, SEGMENT, IDENT, and 
END pseudo instructions. 

C List listing control statements 

WhenCis selected, the listing includes EJECT, SPACE, TTL, and 
TITLE pseudo instructions. A listing instruction that causes an EJECT 
is listed as the first line of the new page after the EJECT takes place 

D Include details 

Selection of the D option causes listing of the follov/ing items not normally 
listed: 

Second and subsequent lines of DATA and DIS 

Code assembled remotely when HERE or END causes its assembly 

Literals block 

Default symbols 

E Include echoed lines 

Selection of E causes listing of all iterations of code duplicated as a result 
of DUP and ECHO. 

F List IF-skipped lines 

When F is selected, the listing includes all lines skipped by IF, IFop, 
IFC, IFPP, IFCP, SKIP, and ELSE. In addition, the Symbolic Reference 
Table contains references to symbols in IF statements. 

G List generated code 

Selection of this option causes listing of all code generating lines regardless 
of list controls other than L. Instructions listed include symbolic machine 
instructions and BSS, BSSZ, CON, DATA, DIS, R=, and VFD. 

L Master list control 

This option Is normally selected. When L is canceled, the laag list contains 
error flagged lines, an error directory, and LIST and END pseudo instruc- 
tions only, regardless of selection of any other cptlons on LIST, 

M List macros and opdefs 

Selection of M causes all lines generated by calls to macros and opdefs other 
than those defined by the system to be listed. 
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N List nonreferenced symbols 

This cation is normally selected. Cancellation of this option causes 
any nonsystem symbol for which no reference has been accumulated 
(e.g. , all occurrences are in IF statements with the F option deselectedj 
or are between CTEXT or ENDX with the X option deselected) to be 
omitted from the symbolic reference table, 

R Accumulate and List references 

This option is normally selected. When R is canceled, COMPASS does 
not accimiulate references. R should not be canceled if a complete 
symbolic reference table is desired. If R is canceled at the end of 
assembly, no symbolic reference table is produced. 

S List systems macros and opdefs 

Selection of S causes all lines generated by calls to systems-defined 
macros and opdefs to be listed. 

T List nonreferenced system sjonbols 

Selection of this option causes a symbol defined through SST to be 
included in the symbolic reference table even if there are no accumulated 
references. 

X List XTEXT lines 

Selection of the X option causes listing of ail statements assembled as a 
result of an XTEXT pseudo instruction. CTEXT and ENDX provide a 
means of alternately turning this external designator off and on. 

$ A dollar sign in the variable field selects all options. 

* An asterisk in the variable field causes selection of the options in effect prior 

to the current selection. The assembler records occurrences of LIST pseudo 
instructions and maintains a table of the most recent 50 occurrences. Each 
LIST * resumes use of the most recent entry and removes it from the list. 
When the subprogram contains more LIST * instructions than there are entries 
in the stack, COMPASS selects the default list options (B, L, N, and R). 



For list options A, C, D, E, F, M, S, and X, all applicable options must be selected for a specific 
line to be listed. For example, listing of an expansion resulting from a DUP within a macro requires 
selection of both M and E. Similarly, an expansion caused by an XTEXT within a system macro call is 
listed only when both X and S are selected. To obtain a listing showing pand ^ marks removed from 
external text inside a DUP range, A, X, and E must all be selected. 



Example: 



172051it631'»631'*631t»6 



2 172051*f631<»631'»6 31^6 

3 i6^031<t&31<(63i^631^& 

172051i*631't631it631^»6 



6 172051«»631it631^f6 31<*6 

7 16<»031'»631^631'*631it6 





LOCATION 


OPERATION 


VARIABIE 


COMMENTS 


1 




)1 


18 isO 














LIST 


A 








DATA 


1.3i*EE 








DATA 


1.3EE 








Llbf 


D 








DATA 


1.3f»££ 








DATA 


1.3EE 








LIST 


-A,-0 








OAfA 


1.3fE£ 








LIST 










DATA 


l«3fEE## 








DATA 


1,3£E 
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4.11.2 EJECT-EJECT PAGE AND BEGIN NEW SUB-SUBTITLE 

The EJECT pseudo instruction advances printer paper to a new page before printing. Then, page 
headings are printed and listing continues. EJECT has no effect, other than setting the sub-subtitle, 
if it is generated by DUP, ECHO, RMT, XTEXT, or a macro or opdef expansion, and the cor- 
responding LIST options are not all selected. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


name 


EJECT 





name 



New program sub-subtitle for the page will be printed in character positions 
70-79 of the second line of the page. A blank name clears the sub-subtitle. 



An entry in the variable field, if present, is ignored. 

4.11.3 SPACE - SKIP LINES AND BEGIN NEW SUB-SUBTITLE 

The SPACE pseudo instruction spaces the assembler listing. When a page is full, an eject occurs 
and listing resumes on the next page. A SPACE immediately foUowing an EJECT is ignored. SPACE 
has no effect, other than setting the sub-subtitle, if it is generated by a DUP, ECHO, RMT, 
XTEXT or a macro or opdef expansion, and the corresponding LIST options are not all selected. 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


name 


SPACE 


sent, rent 



name 



sent 



New subprogram sub-subtitle will be printed in characters 70-79 on the second 
line of the next page heading. A blank name clears the sub-subtitle. 

An absolute expression specifying a positive integer number of spaces between 
the most recent line and the next line of printout. If base is M, sent is assumed 
to be decimal. If sent is omitted or zero, no line is skipped. 



rent An absolute expression specifying a positive integer number of lines that must 

be remaining on the page following spacing. If base is M, rent is assumed to 
be decimal. 

If sent + rent exceeds the number of lines on the page before spacing occurs, the SPACE acts like an 
EJECT. Note that either the eject occurs or the number of spaces are skipped but not both. 



Blank cards or statements can also be used to space the listing. 
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4.11.4 TITLE - ASSEMBLY LISTING TITLE 

The first TITLE pseudo instruction establishes the title that will be printed on each page of the listing. 
A subsequent TITLE instruction generates a subtitle and causes a page eject. U the subprogram does not 
include a TITLE instruction, COMPASS prints the variable field of the first IDENT pseudo mstruction 
as the title. A TITLE instruction without a character string produces an untitled listing. A name in 
the location field introduces a new subprogram sub-subtitle. 

A TITLE instruction has no effect when LIST option X is deselected and the TITLE instruction is 
in text read by XTEXT or is between CTEXT and ENDX instructions. All other TITLE mstructions 
(except the first which sets the main title) cause a page eject, even when generated by a macro 
expansion, unless LIST option L is deselected. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


name 


TITLE 


string 



name 



New subprogram sub-subtitle to be printed in character positions 70-79 
on the second line of the page. A blank name clears the sub-subtitte. 



^Mn^ COMPASS searches the columns following the blank that terminates the 

operation field. If it does not find a nonblank character before the default 
comments column (see COL pseudo instruction), it takes the characters 
starting with the default comments column minus one up to the end ot the 
statement. Otherwise, the title or subtitie begins with the first nonblank 
character following TITLE and continues to the end of the statement or to 
62 characters. Any characters beyond the 62nd are lost. A blank strmg 
produces an untitled listing. 



Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 








lUENT 


hto 1 






LIST 


C 1 






TITLE 
• 


MT DRIVER 1 






• 
• 

TITLE 


I/O ROUTINESi 






• 


i 






• 


1 






• 
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First page: MT DRIVER 



Subsequent pages: mT DRIVER 

I/O ROUTINES 



4.11.5 m-NEW ASSEMBLY LISTING TITLE 

The TTL pseudo instruction introduces a new main title to t>e printed on each page of the listing, and 
clears the subtitle. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


name 


TTL 


string 



name New sub-subtitle to be printed in character positions 70-79 on the second 

line of the pages. A blank name clears the sub-subtitle. 

string COMPASS searches the columns following the blank that terminates the operating 

field. If it does not find a nonblank character before the default comments column 
(see COL pseudo instruction), it takes the characters starting with the default 
comments column minus one up to the statement end. Otherwise, the title begins 
with the first nonblank character following TTL and continues to the end of the 
statement or to the 62nd character. Any characters beyond the 62nd are lost. 
A blank string produces an untitled listing. 

TTL does not cause a page eject. 



4.11.6 NOREF- OMIT SYMBOL REFERENCES 

The NOREF pseudo instruction causes the symbols named in the variable field to be suppressed from 
the symbolic reference table. 

Format: 



1 

lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




NOREF 


sym^jsymg,. .. ,sym^ 



sy^j One or more symbols defined in the subprc^ram. If a symbol qualifier is in 

effect when the NOREF is encountered, the symbols are assumed to be 
qualified by the qualifier in use, unless an unqualified symbol of that name 
is defined before the NOREF and the qualified symbol is not defmed before 
the NOREF. Alternatively, sym , can be a nonblank qualifier symbol en- 
closed by slant bars, /qualifier/, in which case all symbols qualified by 
the specified qualifier are suppressed from the symbolic reference table. 

A location field symbol, if present, is ignored. 
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4.n.7 CTEXT AND ENDX - DISABLE/ENABLE LISTING OF COMMON DECK TEXT 
The CTEXT pseudo instruction sets the XTEXT flag for list control. 

NOTE 

When the flag is set, external text is listed and symbol 
references are recorded, only if the X list oiation is selected. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


name 


CTEXT 


string 



name If X list option is selected, name is treated as a sub-subtitle; other- 

wise it is ignored. 

string If the variable field is nonblank and the X list option is selected, the CTEXT 

is treated as a subtitle. The CTEXT instruction generates a subtitle and 
causes a page eject. If X is not selected, the CTEXT does not affect titling. 

The subtitle begins with the first nonblank character following CTEXT 
or in the default comments column (see COL pseudo instruction) minus 
one, whichever comes first, and continues to the end of the statement 
or to 62 characters. Any characters beyond the 62nd are lost. 

The ENDX pseudo instruction clears the XTEXT flag for list control and causes listing to resume, 
starting with the instruction after ENDX, when the X list option has not been selected. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




ENDX 





Entries in the location field or variable field, if present, are ignored. 
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4.11.8 XREF— REFERENCE SYMBOLIC ADDRESS 



The XREF pseudo instruction provides the options of having the symbolic reference table contain 
references to symbols according to (1) location counter address, (2) page and line number, or (3) bo&. 
For the format of the symbolic reference table, refer to section 11, 8, 

Format: 



LOCATION 


OPERATION 


VARIABLE SOBFIEIDS 




XREF 


string 



string An optional character string, the first character of which indicates how symbols 

are to be referenced. 

A The symbolic reference table lists addresses only. Flags are not included. 

B The symbolic reference table lists references to symbols according to 
p^e number, line, and address. Flags are included. 

P The symbolic reference table lists references to symbols according to 
page and line numbers. Flags are included. 

A location field symbol, if present, is ignored. 

If the string is omitted or if no XREF is issued, the symbolic reference table contains references 
according to page and line numbers and includes flags. The last XREF encountered in a subprogram 
determines the form of the listing for the entire subprogram. 
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DEFINITION OPERATIONS 



This chapter describes pseudo instructions that involve definition operations. These pseudo 
instructions cause sequences of instructions to be saved for these reasons: 

They can be assembled from an external source (XTEXT). 

Assembly can be delayed until later in the subprogram (RMT). 

They can be assembled repeatedly (DUP and ECHO). 

They can be referred to for assembly (MACHO, MACROE or OPDEF). 

Any instructions other than END, including other definitions or calls, can be in the body of a definition. 

Each request for assembly of one of the saved sequences of code, such as a reference to a macro, 
causes an entry in the assembler recursion stack. The most recent entry in the stack points to the 
source of statements (the definition) to be assembled. When the definition contains an inner, nested, 
reference to a saved definition, the stack pointer is changed so that the source of statements is the 
innermost definition. The stack allows nesting of definitions to a maximimi level of 400. When the 
end of a definition is reached, the assembler switches to the preceding entry in the stack. WTien the 
stack is emptjs the assembler resumes assembly of the next statement in the input source deck. 
A nested definition must be wholly contained by its next outer definition. 

Definitions are saved compressed but otherwise unedited (with micro and concatenation marks). Editing 
occurs each time the definition is processed. Compression removes blanks and replaces them with 
coded bytes as follows : 

A single space is represented by 55g; it is not compressed. Two or more embedded spaces are 
replaced in the image as follows : 

2 spaces replaced by 5555g 

3 spaces replaced by 0002 

4 spaces replaced by 0003 

• • • 

64 spaces replaced by 007 7 g 

65 spaces replaced by 007755g 

66 spaces replaced by 00775555o 

67 spaces replaced by 00770002 etc. 

o 

Trailing spaces are considered as embedded and are included in the image. The 00 character 
(colon) is represented by the 12-bit code 0001. A 12-bit zero byte marks the end of the statement. 

The listing identifies the source of statements and the recursion level for all definition operations. 



60492600A 



5-1 



For XTEXT, DUP, and ECHO, assembly occurs as soon as a definition is saved. Unless the definition 
contains a USE, USELCM, or ORG instruction, code is assembled into the block in use when the 
XTEXT, DUP, or ECHO is encountered. For RMT, macros, and opdefs, however, definition and 
assembly take place in two steps. The block in use at definition time does not determine where code 
in the definition will be assembled. That is, code is assembled into the block in use when the definition 
is assembled if the definition does not itself contain a USE, USELCM, or ORG. 

Similarly, for XTEXT, DUP, and ECHO, any qualifier in effect when the pseudo instruction is 
encountered applies to symbols defined in the sequence (assuming the sequence does not contain a 
QUAL). For RMT, macros, and opdefs, however, because definition and assembly take place in two 
steps, the qualifier in use at definition time does not affect symbols in the definition. The qualifier, 
if any, in effect when the definition is assembled is applied to the symbols defined in the sequence. 

A qualifier applies to symbols only. It does not apply to block names or to the names of DUP, ECHO, 
RMT, or macro definitions, nor to any substitutable parameter names. 

In definitions having substitutable parameters, it is possible to use a different block name, different 
qualifier, or different symbols with each expansion simply by declaring either the qualifier symbol, 
block name, or sjrmbols to be qualified as substitutable parameters. (For an example, refer to 
example 7 under Macro Call. ) 

5.1 EXTERNAL TEXT (XTEXT) 

The XTEXT pseudo instruction provides a means of obtaining source statements from a file other than 
that being 4ised for input. COMPASS transfers the text from the external source and assembles it 
before taking the next statement from the interrupted source of statements. The file may be a sequential 
file, an indexed file with named records, or an UPDATE or MODIFY''' random-access program library 
file. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


file 


XTEXT 


mame 



file Name of a file containing source statements. If file is omitted, COMPASS 

assumes the file named in the X parameter on the COMPASS control statement 
(section 10. 1. 2). If no X parameter was specified, COMPASS assumes OLDPL. 

mame If mame is blank, COMPASS assumes that the file is sequential; it rewinds the 

file and reads the first section. If mame is not blank, it is the name of the 
section to be read. The file must be a SCOPE 3 indexed file with named 
records, a record indexed file with named records, a random-access program 
library file in UPDATE format, or a random-access program library file in 
MODIFY format. 



MODIFY is not supported by NOS/BE 1 and SCOPE 2. 
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Text records may be In any of the following formats; 

1. Normal text. If the first line contains mame starting in column 1, it is skipped. 

f 

2. A common deck in an UPDATE or MODIFY' random-access program library file. If the file 
is in UPDATE format, the first line (*COMDECK rname) is always skipped. If the file is in 
MODIFY format, the identification (7700) and modification (7702) tables are skipped. COMPASS 
does not recc^nize UPDATE or MODIFY directives such as *IF in the common deck. 

f 

3. An UPDATE or MODIFY' compressed compile file section. 

COMPASS reads source statements to an end-of-section mark or an END pseudo instruction. 



5.2 REMOTE ASSEMilY 

Definition and assembly of remote code takes place in two steps. A pair of RMT pseudo instructions 
delimit code that is to be saved for later assembly. Later, a HERE pseudo instruction directs 
COMPASS to assemble a specific sequence of remote code or to assemble all unlabeled remote code. 
An END instruction causes any unlabeled remote code to be assembled. 

5.2.1 RMT -SAVE REMOTE CODE 

A RMT pseudo instruction signals the beginning or the end of a sequence of code to be assembled 
remotely. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELOS 


rmtname 


RMT 





rmtname Optional 1-8 character name identifying the remote sequence. It is 

significant on the beginning RMT only. The field is ignored for a terminating 

RMT. If supplied, rmtname can be used on a subsequent labeled HERE. 

If the sequence is unlabeled, an unlabeled HERE or END causes its assembly. 

A variable field entry, if present, is ignored. 

Any instruction legal when the remote lines are called for assembly is legal between the RMT pair. 
If expansion of an RMT reveals a second RMT pair implicit to the saved definition, assembly of the 
first pair must occur through a HERE instruction so that the inner pair will be expanded by an END. 
Similarly, if the assembly of the second pair reveals yet a third RMT pair, the second pair must be 
assembled through a HERE rather than the END, etc. 

Any labeled remote code present when END is processed is discarded without notice. 



MODIFY is not supported by NOS/BE 1 and SCOPE 2. 
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5.2.2 HERE - ASSEMBLE REMOTE CODE 



A HERE pseudo instruction causes the labeled remote sequence to be assembled or unlabeled saved 
remote sequences to be assembled. In the absence of a USE, USELCM, IDENT, or an ORG within 
;he saved sequence, the remote code is assembled under the block in use at the time the HERE is 
ancountered. hi the absence of a QUAL within the saved sequence, symbols are qualified under the 
qualifier in use at the time the HERE is encountered. RMT code is assembled only once. After it 
is assembled, it is no longer saved. A HERE encountered when there is no remote text saved has no 
effect on assembly. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


rmtname 


HERE 





rmtname Optional; the name of a previously saved RMT sequence. CMy the named 

sequence will be assembled at this time. 

A variable field entry, if present, is ignored. 

If imlabeled remote sequences still remain to be assembled when the END statement signaling the end of 
assembly is encountered, COMPASS assembles them before it terminates assembly. However, any 
RMT pairs that might have resulted from the assembly are lost. Also, any remaining labeled remote 
code is lost. 

Examples: 

The following example illustrates use of RMT within a macro definition. Following the last call to 
the macro, a HERE causes all saved unlabeled RMT sequences to be assembled. 
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Location 



Code Generated 



47?7 

1331 

4727 000000000 000Ofl03£304 



4730 

1332 

4730 00000000000000032304 



4731 



1332 
4730 



4673 
4673 
4673 



lOCATIOM 



TNAM 
O.TNAM 

TNAM 
O.TNAM 



OPERATION 



MACRO 
ifC 
EQU 
CON 

^ lu ^ 

EQU 
EQU 



EQU 



LNDM 





TABLE 




IFC 


INTER 


. EQU 


0*- INTER 


COM 




RMT 


L„ INIER 


E':u 




RHT 




ENOH; 


lastab 


TABLE 




IFC 


LA STAB 


EQU 


O^LASTAS 


COH 




ELSE 






La. AS TAB 


EQU 




RMT 




EN DM 


NRTA8 


TABLE 




f-LSc 


NRTAB 


EQU 


0«NRTAB 


. EQU 




RMT 


L»NRTAB 


EQU 




nm 








• 
e 

HERE 


Le BITER 




L ^LASTAB 


j EQU 


L.NRTA8 


EQU 



COMMENTS 



30 



TABLE? TNAMf EQIV 
EQt««EulV* 

^-ORIGINS 
BUCKET 
2 

EQIV 
O.EQIV 



TMAM*SI2ES 



^--ORIGINS 
BUCKET 



INTER*SI2ES 



EC*^-^*» 

^-ORIGINS 
BUCKET 

2 



LASTAB^SIZES 



ASTA8 

LASTAB , ■ 
0*LASTAB 

■ I 

NRTAS*SI2ES 



LASTAO^SItES 



TABLE 


.1 


TABLE 


*1 


TABLE 


»1 


TABLE 


«1 


TABLE 


«l 


TABLE 


«i 


TABLE 


.1 


TABLE 


«1 


TABLE 


*l 


TA8LE 


«l 


■TABLE : 


*l 


TABLE 


«1 


TABLE 


«1 


table;,.^ 


*l 


^■TABLE"^' 


• I 


TABLE 


■ •! 


TA3LE 


©1 


TABLE. 


• 1 


TA8LE ■ 


* i 


TABLE: ^ 




TABLE 




TASLE : 
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In the following example, assembly of the RMT sequence is caused by the END statement. 





IDC ATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 130 






RMT 


1 






FLD 


DECMIC 


8UF*BUFL-WSA*ENDS 






PRS 


LIT 


C^^FLD^ DECIMAL REQUIRED,* 
1 








LIST 


1 

. , ■ C 1 . 






FLD 


DECMIC 


BUF^BUFL-ySA^-ENOS 






PRS. 


LIT 


C^^FLO^ DECIMAL REQUIRED*^* 






PRS 


LIT 


C«25759 DECIMAL REQUIRED,.--' 

. . ,..,.„,,.., 





5.3 CODE DUPLICATION 

This section describes two pseudo instructions (DUP and ECHO) that cause a sequence of code to be 
assembled repeatedly. For a DUP sequence, each assembly is identical with the first, and the 
number of repetitions is specified or is indefinite. For an ECHO sequence, each assembly resembles 
a macro reference. Actual parameters supplied in a list are substituted for formal parajneters on 
each repetition of the code sequence. The number of repetitions is determined by the number of 
actual parameters provided on the ECHO instruction. 

Every inner DUP or ECHO sequence must lie totally within the range of the next outer DUP or ECHO, 
or a fatal E error is flagged. 



5.3.1 DUP - SIMPLE DUPLICATION 

The DUP pseudo instruction specifies repeated assembly of the statements immediately following. 
The range of the DUP is specified either by a source statement count on the DUP instruction or by an 
ENDD. 

Format: 



LOCATION 


OPERATION 


VARIABLE SU6FIEL0S 


dupname 


DUP 


rep,jEact 



dupname Optional name of the DUP sequence; 1-8 characters. When supplied, it can be 

used in an ENDD. When no name is supplied, the range of the DUP is determined 
by a statement count or by any unnamed ENDD. 

rep Absolute evaluatable expression specifying the integer number of times state- 

ments in the DUP range are to be assembled. If rep is null or zero, the instruc- 
tions in the range are not assembled; that is, code is skipped. When base is M, 
COMPASS assimies that rep is decimal. 
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NOTE 



A very large (unobtainable) repeat count in conjunction with a 
STOPDUP instruction can be used for indefinite duplication 
of code. 

£nct An evaluatable expression specifying an integer count of the number of 

statements to be assembled repeatedly. When base mode is M, COMPASS 
assumes that met is decimal. The count is decremented for statements only; 
comment lines (identified by * in column one) are not counted. On each 
iteration, the assembler copies the source statements and then assembles 
them. Thus, any recursive statements within the sequence are counted 
before they are expanded. 

The aupname and j&ict parameters are related. 

1. If a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD is to 
be included in the count. Under count control, a name is irrelevant. 

2. If neither a count nor a name is supplied, the DUP range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the DUP range is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not effect the 
range. 

5.3.2 ECHO - ECHOED DUPLICATION 

The ECHO instruction specifies repeated assembly of the instructions immediately following. On each 
iteration, the assembler copies the source statements substituting an actual parameter in the list for 
each formal parameter until the shortest list is exhausted, and then assembles the statements. ECHO 
offers many of the features of macros but does not require separate definition and reference. The 
range of the ECHO instruction is specified either by a source statement count specified on the ECHO 
instruction, or by an ENDD. The statement count, when used, is decremented for instructions only; 
comment lines, identified by * in column one, are not part of the definition and are not counted. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


dupname 


ECHO 


jmct,p^=(list^),P2= 


(list2),...,Pj^ =(listj^) 



dupname Optional name of the ECHO sequence; 1-8 characters. When supplied, 

it can be used in an ENDD. When no name is supplied, the range of the 
ECHO is determined by a statement count or by any unnamed ENDD. 
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fnct C^tional absolute evaluatable expression specifying an integer count of the number 

of source statements to be assembled repeatedly. If base mode is M, the 
count is assumed to be decimal. If £nct is zero or omitted, the comma must 
be present and the ECHO range is defined by an ENDD. 

Any recursive statements, such as macro references, are counted before 
they are expanded. 



If the count exceeds the range of an outer DUP or ECHO sequence, a fatal 
E error is flagged. 



The dupname and Unct parameters are related. 

1. If a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD in a 
count- controlled sequence is for it to be included in the count. Under count control a name 
is Irrelevant. 

2. If neither a count nor a name is supplied, the ECHO range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the ECHO range is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not terminate 
the sequence. 

Pj Names of not more than 63 formal substitutable parameters. Each name is 1-8 

characters, the first of which must be alphabetic. A name cannot be END, 
LOCAL, ENDD, IRP, or ENDM. A second or later occurrence of a parameter 
name is ignored. A name that begins with a number is ignored. The substi- 
tutable parameter name can occur in any field within a definition. 

The separator between pj and (listj^) is conventionally an = but can be any of the 
following: 

+ -*/()$=, or . 

COMPASS recognizes a substitutable parameter name within a definition when it 
is between any two of the following: 

: +-*/()$ = blank , . ?^ or 



Before the ECHO definition is stored, COMPASS replaces each use of a 
substitutable name. Otherwise, it saves the definition unedited, i. e. ^ with 
micro and concatenation marks. Use of the semicolon is restricted in the 
definition because the assembler, when it expands the definition, interprets it 
as a substitutable parameter flag (77g). 
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The character r* flags the occurrence of a name not bounded by any other 
special character and, thus, not otherwise recognized. When it expands the 
definition, COMPASS substitutes an actual parameter value from the list for 
the substitutable parameter and removes the r* so that the adjacent items are 
concatenated. 

Because the assembler replaces the first substitutable parameter with 7701, 
the second with 7702, etc. the programmer can use the display characters 
;A, ;B, etc. directly in place of his substitutable parameter names in the 
definition and achieve the same results as if the assembler had replaced the 
name with the flag. (Example 8, section 5. 4. 3 illustrates a similar application 
of this technique. ) 

(listp Actual parameter list in the form a^, ag, . . . , where a^ is substituted for pj^ 

on the first assembly of the ECHO sequence, ag is substituted on the second 
assembly, etc. until the shortest list is exhausted. Two consecutive commas 
are interpreted as a null parameter. An explicit zero, if desired, must be 
entered. An actual parameter can contain a set of embedded parameters 
enclosed by parentheses. However, the embedded parentheses must be 
properly paired. The assembler removes the outer pair of parentheses before 
substituting the embedded set In a line. A parenthetical item can contain blanks 
or commas. 

If there are no parameters or any of the lists are :null, COMPASS assembles the 
ECHO sequence zero times, effectively skipping it. 



5.3.3 STOPDUP - STOP DUPLICATION 

The STOPDUP instruction allows premature termination of a DUP duplication before the repeat count 
is reached or of an ECHO duplication before the shortest list is exhausted. Assembly is completed to the 
end of the range for the current iteration and then continues with the next source statement. Only the 
innermost duplication is affected. 

A STOPDUP outside of a DUP or ECHO range has no effect on assembly. If a DUP or ECHO is nested, 
STOPDUP terminates only the innermost DUP or ECHO. 

Format: 



tOCATION 


OPERATION 


VARIABLE SUBFIEIOS 




STOPDUP 





An entry in the location or variable field is ignored. 
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5.3.4 ENDD - END DUPLICATION SEQUENCE 



The ENDD pseudo instruction terminates a DUP or ECHO sequence when the statement count is 
unspecified on the DUP or ECHO. 

Format: 



lOCATION 


OPERATION 


VARIABIE SUBFIEIDS 


dupname 


ENDD 





dupname Name of a DUP or ECHO sequence, or blank. A named DUP or ECHO 

sequence can be terminated by an ENDD specifying the sequence by name, 
or by any unnamed ENDD. An unnamed DUP or ECHO sequence that is not 
controlled by statement eoiuit is terminated only by an unnamed ENDD. 
An ENDD does not terminate a sequence controlled by a statement count. 
The ENDD is included in the count but has no other effect. 

An ENDD outside the range of a DUP or ECHO has no effect on assembly. 

ENDD is part of the definition it terminates; consequently, it is not edited at ECHO definition time. 
The following definition is in error: 

T r* 1 ECHO 
Code 

T r- lENDD 

In this code, the location field of the edited ECHO statement is Tl, but the location field of the un- 
edited ENDD statement remains at Tr*!. 



Elxamples: 



In the following examples, the statements that result from expansion are shown shaded . They are 
listed only when the E list option is selected. &)urce statements are shown in bold characters. 



1, This example illustrates use of a simple DUP instruction. 



Location Code Generated 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




11 


18 


30 


OOOOOS 

5153 OOOOOOOOOOOOOOOOOCOl 

5154 OOOOOOOOOOOOOOOOOCOl 

5155 0000000000000000000 1 

5156 00000000000000000001 

5157 OOOOOOOOOOOOOOUOOOO 1 






01 IP 

DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


\ 


«DUP» 1 

*UUP« 1 
«OUP« 1 
«OUP« 1 
«OUP* 1 
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2. This example illustrates a nested DUP instruction with one of the DUP duplications terminated 
by a STOPDUP. 



lOCATION 



GO 

TAG 



GO 

ALPHABET 

NO 



TAG 
TAG 



Mo 



TAG 
TAG 



TAG 
AG 



OPERATION 



VARIABIE 



COMMENTS 



I 30 



MACPO 
MICRO 
IPC 
STOPDUP 
SFT 
ENDH 
MlC»0 
SCT 
DUP 
GO 

ENOn 
GO 

MICRO 
MICRO 
IPC 
IPC 
STOPOUP 
SET 

EN DO 
GO 

MICRO 
MICRO 
IPC 
IPC 
STC^OUP 
SET 

ENDO 



GO 

MICRO 
MICRO 
IPC 
IPC 
STOPDUP 
SPT 
EN DM 
ENDD 



NO* 1 «/»:ALPHAHET#/ 

EQ»/*TAG^/E/. I ASSEMBLE STOPDUP WHEN TAG=E 



NO*l 



1 f f/AHCDEPGHIJK/ 
I 

-I 



NO IS 6 IN LAST ITERATION 



UNOBTAINABLE ITERATION COUNT 



N0« 1 s-/^ALPHABET#/ 
NOf i ^/ABCDEFGHUK/ 

EO^/tl m^/E/<>l ' ASSEMBLE' STOPOUP WHEN TA6=£ 
FOf/A/h./*! ASSENHLc STOPDUP WHEN TAG"^ 

'\0*I HO IS 6 IH LAST ITERATION 



NiO. 1 */^&LPHA>^ET5*/ 
NO* i , /ABCDEFGJIJK/ 

F f) , / ? f AG^/E/ » 1 ASSEMfiLE STG-DuP ft'HEN T AG^E 

FQ»/^Ve/«i ASSEH'riLE STOPDUP wH£N TAG-E 

NO* I NO IS 6 IN LAST UERAriO/M 



NO, ! , /^tALPHABET// 
N0» 1 */AHCD£F6HlJi</ 



EQ*/^TAG?^/E/» I 
EQ,/E/E/» 1 

NO + 1 



ASSEMBLE 
ASSEMBLE 



STOPOUP 
STOPDUP 



WHEN TAG=E 
WHEN TAG~E 



NO IS 6 IN LAST ITERATION 



»DUP^ 

GO 

GO 

GO 

GO 

GO 

GO 

GO 

60 
GO 
GO 
GO 
60 
GO 
;G0 ■ 
■»OUP* 



SOUP* 

GO 

GO 

GO 

GO 

GO 

GO 

GO 

«DUP» 
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3. This example illustrates nested ECHO instructions. A statement count terminates the second 
level ECHO The ENDD terminates the first level. Notice how COMPASS assembles each 
copy before it begins the next iteration. 



Location 



Code Generated 



452 

455 
.456 
.460 
461 



1463 
1464 
1466 
1467 
1471 
147? 



1474 
1475 
1477 
1500 
1S02 
1503 

1505 



1450 

5415 0036 
1450 

5415 0037 
14S0 

5415 0040 



1460 

5415 0036 
1460 

5415 0037 
1460 

5415 0040 



1470 

5415 0036 
1470 

5415 0037 
1470 

5415 0040 
5415 15?4 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




n 


18 ho 














PPU 
• 


i 

1 








STM 


• 
• 

PPOP 


1 
1 

5*5415B j 










LIST 


M,0»E 1 










ECHO 


«CM-(X»Y»Z) 1 










ECHO 


?,Pl= (A,B*C)i 










LDN 


CM j 










STM 


PI 1 










ENDD 












ECHO 


?fP 1= < A,B»C)| 


*^ECHO« 


1 






LDN 


X { 


*ECHO 


1 






STM 


Pi 1 


t^ECHO 


■ I . 






LDN 


X 1 


^ECHO 


2 






STM 


A 1 


*>ECHO 


2 






LDN 


^ 1 


^ECHO 


2 






STM 


B ' . ^ ■ i 


■4* EC HO 


2 






LON 




■*ECHO 


2 






SIM 


c .:.| , 

i 


*ECHO 


2 






ENDD 




**ECHO 


1 






ECHO 


2 « P i = { A 9 B ♦ C ) i 


«ECHO 


1 






LDN 


Y 1 


«ECHO 


1 






STM 


Pi 




i 






LDN 


Y 1 


«ECHO 








STM 




■»ECHO 


2 






LDN 




•!$• c" r" (-1 A 


c 






STM 


•3 1 


*ECHO 


2 






LDN 


^ i 


*ECHO 


2 






C T M 


C ' 


: *ECHD 


2 






ENDD 


1 


*EChO 


1 






ECHO 


?*Pl = (A»B»C)j 


^^ECHO 


1 






LDN 




^ECHO 


1 






STM 


Pi 1 


<JEC HQ 








LDN 


7 1 


**ECHO 


2 






STM 




»ECHO 


2 






LDN 


I 1 


«ECHO 


2 






STM 




*eCHO 


2 






LDN 




<*ECHO 


2 






STM 


c 1 


*ECHO 


2 






ENOD 




«ECHO 


1 






STM 


TAG 1 







5-12 



60492600A 



5.4 MACROS AMD OFDIFS 



A macro or opdef definition is a sequence of source statements that are saved and then assembled 
whenever needed through a macro or opdef call. A macro call consists of the occurrence of the 
macro name in the operation field of a statement. It usually includes parameters to be substituted 
for formal parameters in the macro code sequence so that code generated can vary with each assembly 
of the definition. 

An opdef call differs from a macro call in that the assembler interprets the call by examining the 
format or syntax of the instruction rather than the contents of the operation field alone. The instruction 
comprising the opdef call usually includes parameters to be substituted for parameters in the code 
sequence. There are some differences in the way parameters are substituted, however, as is further 
described under Opdef Call. 

Use of a macro or an opdef requires two steps, definition of the macro or opdef sequence, and calling 
of the definition. 

A definition consists of three parts: heading, body, and terminator. 

Heading A macro definition is headed by a MACRO or MACROS pseudo instruction 

stating the name of the macro and identifying substitutable parameters in 
the body of the macro. 

An opdef definition is headed by an OPDEF pseudo instruction stating the syntax 
of the calling Instruction and identifying substitutable parameters in the body of 
the macro. 

The heading optionally includes one or more LOCAL instructions identifying 
S5rmbols local to the definition. 

Body The body begins with the first statement in a definition that is not a LOCAL 

statement or a comment line. A comment line can be either identified by * 
in column one or can have colimans 1-29 blank. (Following the first statement 
of the macro body, only comments identified by * in column 1 are ignored. ) 

Use of the semicolon is restricted because when a definition is expanded a 
semicolon is interpreted as a substitutable parameter mark or a local symbol 
flag. 

The body consists of a series of symbolic instructions. All instructions other 
than END, including other macro and opdef definitions and calls are legal within 
a definition. However, a definition within a definition is not defined until the 
outer definition is called. Therefore, an inner definition cannot be called before 
the outer definition is called. 

A name of a substitutable parameter or local symbol listed in the heading can 
occur in any field within the body. A reference to a substitutable parameter or 
local symbol is recognized when it is between two of the following characters in 
an ejq)ression or field: 

. +_*/()$= blank , . 7^ or 1— 

The character!— flags the occurrence of a name not bounded by any other special 
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character, and, thus, not otherwise recognized. On a call, the assembler 
substitutes an actual parameter value for the substitutable parameter and 
removes the f— * so that the adjacent items are concatenated. 



NOTE 

The programmer can legally use the characters . ( ) : 
$ and =in symbols, but when he does, he must be careful 
that these characters are not interpreted as delimiters in 
macro definitions (example 4 under macro calls). A symbol 
should not begin with a colon; if it does, the colon is 
ignored and no error message is issued. 

The macro body optionally contains IRP pseudo instructions that allow iterative 
assembly of a sequence within the body such that each iteration uses a different 
parameter value. 

Terminator An ENDM pseudo instruction terminates a macro or opdef definition. 

Definition 

Processing A macro or opdef can be defined anywhere in a subprogram before it is called. 

When COMPASS encoimters a definition, it places the name of the macro or the 
syntax of the opdef along with the number of substitutable parameters and local 
symbols in the assembler operation code table. Before the definition is saved, 
COMPASS replaces each occurrence of a parameter name or local symbol with 
a 77xx (where xx is a number assigned to the substitutable parameter or local 
symbol). 

On the call, each use of a substitutable parameter (each 77xx) is replaced by 
its actual parameter; each use of a local symbol is replaced by a unique symbol 
generated by the assembler. Usually, symbols replaced in this way have no 
meaning outside the definition. However, if the macro includes an RMT 
sequence which contains local symbols, the local symbols will have meaning 
where the remote code is assembled outside of the definition, 

5.4.1 ENDM -END MACRO DEFINITION 

An ENDM terminates a macro or opdef definition. 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


mname 


ENDM 





mname Name of a macro sequence, syntax of an OPDEF sequence, or blank. 
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An ENDM specifying a macro by name terminates the named macro definition and any unterminated 
macro or opdef definitions within it. An ENDM tliat does not specify a macro by name terminates all 
unterminated definitions. An ENDM outside the range of any macro sequence has no effect other than 
to be included in statement counts. 

ENDM is part of the definition it terminates; consequently, it is not edited at MACRO definition time. 
The following definition is in error: 

Tr->1 MACRO 

Code 
Tr*l ENDM 

In this code, the location field of the edited MACRO statement is Tl, but the location field of the 
unedited ENDM statement remains at Tr^l. 

Example: 





lOCATlON 


OPERATION 


VARIABIE 


COMMENTS 


I 




1) 


18 


iso 












JAY 


HACRO 


P1,P25PS 


1 
1 
1 




KAY 


KACROE 


PK2,PK2rPK3 


1 

1 




JPX/XQ 


OPDEF 


0P1,0P2,0P3 


1 

! 

1 




KAY 


ENOH 
ENOH 




1 

' TERMINATES KAY AND 
1 THE OPDEF DEFINITION 

1 

' TERHINATES JAY 
1 



5.4.2 MACRO - MACRO HEADING 

A MACRO pseudo instruction notifies the assembler to place the instructions forming the body of the 
macro in a table of macro definitions for assembly upon call and place the macro name in the operation 
code table. 

The MACRO pseudo instruction has two forms: 
Format one : 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


mname 


MACRO 


parameters 
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Format twb: 



LOCATION 


OPERATION 


VARIABIE SUBFIEIDS 




MACRO 


mname, parameters 



The blank location field identifies the second format. 

mname A legal name other than END, ENDD, IRP, LOCAL, or ENDM. 1-8 characters. 

A name that is identical to a PPU symbolic machine instruction, pseudo 
instruction, or macro already in the operation code table redefines the 
instruction. The most recent definition applies for the macro call. A 
redefinition causes an informative flag to be issued but the new definition 
holds. 

parameters Names of substltutable parameters. The order in which names are listed 

determines the order in which parameters must occur in the macro call. 
Each name is 1-8 characters, the first of which must be alphabetic. A name 
cannot be END, IRP, LOCAL, ENDD, ENDM, or the same as a local symbol. 
A name that begins with a number, or a second or later occurrence of a para- 
meter name in the list is ignored. 

Any of the following special characters separate parameters in the list: 

+ -*/()$=, or . 

These characters have no meaning other than as separators. A blank 
terminates the list of parameters. Also, any of these characters can be used 
to separate the mname from parameters in format two. 

The total number of imique parameter names and local symbols must not 
exceed 63 for any one macro definition. 

Format one does not require parameters. 

Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a fatal error and 
ignore the definition. 

The assembler ignores a blank parameter produced by two adjacent 
separators or by a separator at the end of the list. 

For an example of definition and calls, refer to Macro Calls. 
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Examples of macro instructions: 



1. Legal MACRO instructions: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




n 


18 t30 




ABC 


HACRO 


_____ 1 _ 

PI » P2 ? P3 ^ 






MACRO 


DEF*L0C*ONE*TW0»TEN 




HESSAGE 


MACRO 


ft ' 



2. MACRO instructions having identical parameter lists. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 


|30 




sun 


MACRO 




(SECOND X PARAMETER IS IGNORED 




SUM 


MACRO 


X(Y"«-Z) 






SUH 


MACRO 








SUM. 


HACRO 


X,Y, fZ*X) 


'null parameter and second 

|X ARE ignored 




RAO 


HACRO 


K 






RAO 


HACRO 


K=X4-1 


t second X AND numeric 



parameter are ignored 



3. Illegal use of format two: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 


ho 






macro 
macro 

HACRO 


ABC 

ABCFP 
A8C.16»FP 


1 NO SUBSTITUTA8LE PARAMETER 

1 NULL PARAMETER FIELD 

t NUMERIC PARAMETER FIELD 
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5.4.3 MACRO CALLS 

A macro headed by a MACRO pseudo instruction can be called by an instruction in the following format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIOS 


sym 


mname 


Pl,P2.---»Pn 



sym 
Pi 



Optional; depends on definition (see discussion following) 

Parameter list composed of alphanumeric strings. Parameters are separated 
by commas and terminated by a blank. Two consecutive commas constitute 
a null parameter. An explicit zero, if desired, must be entered. 



Each parameter must be in its correct relative position depending on the sequence 
in which its formal substitutable name is given in the MACRO pseudo instruction. 

When the definition MACRO is in format one, the first parameter in the call is substituted wherever the 
first substitutable parameter occurs in the definition, the second parameter in the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. When the definition IVIACRO 
is in format two, the location field entry in the call is substituted wherever the first substitutable 
parameter occurs in the definition, the first parameter in the variable field of the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. 

If null parameters are interspersed with legal parameters, the correct positions must be established 
with commas. When the list terminates before the last possible parameter, all remaining parameters 
are considered null. 

When the first character of a parameter is a left parenthesis, the assembler considers all the 
characters between it and the matching right parenthesis as an embedded parameter or as an iterative 
parameter. It is an iterative parameter when the substitutable parameter has been named in an IRP 
pseudo instruction (section 5. 4. 9). Otherwise, it is an embedded parameter. 

The assembler removes the outer pair of parentheses before substituting the enclosed character string 
in a line. Embedded parenthetical items must be properly paired. A parenthetical item can contain 
blanks and commas. 



Example : 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 








MESSAGE 


(=:C*PROGRAH 


1 — 

lABORT,^) 
1 



After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 
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Processing of a location symbol and forcing upper of the first macro instruction depend on the MACRO 
form used for the definition. 

If the macro is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of generated code upper. The location field symbol 
is assigned the current value of the location counter. A location field (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using format two, that is, the macro name is in the variable field and the 
first parameter is a location argument, the location symbol of the call is substituted for the first 
parameter or location argument. The fact that this argimient came from the location field rather than 
the variable field has no special significance in the macro expansion. In the macro call, the location 
field argument cannot be more than 8 characters. Parentheses are not given the special meaning used 
in the variable field of a macro call line. 

Example : 

1. An illustration of concatenation 



Location Code 

Generated 




LOCATION 


OPERATION 


VARIAEIE 


COMMENTS 




I 




II 


18 


30 


















MACK 


MACRO 


P1»P2 












• 














• 
• 

ENOM 
• 














• 
• 

MACK 


A2,A 












S^A2 


A2*-lPr»A 




.1 


A740 5022000001 






SA2 


A2* IPA 


MACK 


.1:,:.. 








ENOM 




MACK 


.1 
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2, An illustration of nested definitions and calls 



lOCATION 



NAME! 



NAHE2 



NAME2 



NAHEl 



OPERATION 



HACRO 



MACRO 



ENUH 



NAME2 



ENOH 



NAHEl 



NAME2 



VARIABIE 



COMMENTS 



30 



AT THIS TIME* THIS LINE 
IS PART OF A OEFIMITION 
RATHER THAN BEING A CALL. 



NAMEl IS CALLED AND EXPANUED, 



CALL TO NAHE2 IS VALID 



1 



3. The following example illustrates two calls to a definition headed by a MACRO in format two 
using the location argument. The macro is named TABLE; its substitutable arguments are 
TABNAM, VALUEl, and VALUE2, where TABNAM is the location argument. 



Location 



Code Generated 



47^f 1 



1 7204000000 OOOOOOOUO 
17214000000000000000 



4743 
4743 
4744 



17204000000000000000 
OOOOOOOOOOOOOuOOOOOO 



LOCATION 



TABNAM 



SPVAL 
PVAL 



VFD 



OPERATION 



MACHO 

VFD 

ENOM 



TABLE 
VFD 

ENQM 



TABLE 



VAKIASIE 



COMMENTS 



1 30 



T ABLE ♦ TABNAM, VALUE i«VALUE2 
oO/VALUEl •6j)/VALUE2 



i .0*2.0 ! CALL ONE 
60/1 .Of 60/2.0 



1.0 

60/1 .0,60/ 



ENDM 



CALL IWO 



TABLE 
TABLE 

TABLE 
TABLE 
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4. An illustration of embedded parameters: 



Definition: 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


iso 






MACRO 

LDH 
LJM 
ENOM 


ft 

B 




Call: 










lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


J 




11 


18 ho 






XflM 


(SUM,inE 


t (SAM,IND3) 



E^ansion: 



Location Code Genfirated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


7303 5010 12^^ 
7305 0117 72^3 


1 




II 


18 iao 






LDM 
LJM 
ENDM 


SUM*! OR 1 
SAMWND3 1 
1 
1 



5. The following example illustrates use of R= in macros: 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 IsO 












ONSN 


H&CRO 


N 








R= 


XI, N 








SX2 


IIB 








RJ 


=XCPM= 








ENOM 








OFFSW 


HACRO 


N 








R= 


Xi,N 








SX2 


12B 








RJ 


=XCPM= 








ENOM 
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6. The following example illustrates a character in a symbol erroneously being interpreted as a 
delimiter for a parameter. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




11 


18 |30 




ABC 

z 


MACRO 
SET 
SA7 
• 


Z,VAL»P5 
VAL 

2. ALPHA 
• 


1 
1 

[ILLEGAL SYMBOL, TOO 
1 


LONG 




IOTA 


• 
• 

ENDM 
ABC 

SET 

SA7 
ENDM 


• 
• 

IOTA, 1 ,3 

IOTA. ALPHA 


1 
1 
i 

j ILLEGAL SYMBOL* 
1 


00 LONG 



7. The following example illustrates changing of control blocks and symbol qualifiers through 
substitutable parameters in a macro. (The same call could be used by using micros to 
change actual parameters, ) 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 i30 




TAB 


MACRO 


BLOCK, KWAL 










USE 


BLOCK 1 










OUAL 


KWAL i 








TAGl 


BSS 


lOB 1 








TAG2 


VFD 


60/-1 1 










USE 












DUAL 


« 1 










ENDM 
• 












• 
• 

TAB 


ONE, ONE 1 










USE 


ONE ' 


TAB 


• 1 






OUAL 


ONE 1 


TAB 


• 1 




TAG! 


BSS 


lOB 1 


TAB 


• 1 




TAG2 


VFO 


60/-1 i 


TAB 


• 1 






USE 


a \ 


TAB 


• ] 






OUAL 


-ft t 


TAB 


• 1 






ENDM 




TAB 


• \ 






TAB 


TWO, TWO 1 










USE 


TWO ! 


TAB 


• 1 






QUAL 


TWO j 


TAR 


• 1 




TAG! 


BSS 


lOB 1 


TAB 


• I 




TAG2 


VFO 


60/-1 1 


TAB 


• 1 






USE 


« 1 


TAB 


• 1 






QUAL 


» 1 


TAB 


• \ 






ENDM 


y ■ 


TAB 


• 1 
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8. The following example illustrates a technique that an experienced programmer may wish to 
use to save time in processing of definitions. Remember that the assembler replaces the 
first substitutable parameter with 7701, the second with 7702, etc. Note that 7701 is ;A in 
display characters, 7702 is ;B, etc. This means that the programmer can use the display 
characters directly in place of his substitutable parameter names in the body of the definition 
and achieve the same results as if the assembler had made the substitution when it saved the 
definition. At the time the definition is assembled, the assembler replaces each 77xx with the 
actual parameter whether the code was inserted by the assembler when it saved the definition 
or by the programmer when he coded the definition. 



7771 00000000000030 101043 
777? 

777? 00000000000031111144 
7773 

7773 00000000000013?060^S 
7774 

7774 00000000000015404046 
777S 

7775 00000000000012'5454£f7 
7776 

7776 0000000000001761?150 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


t 




11 


18 


!30 




CHAR 


MACRO 


ASC 1 1 * INTERNAL* EXTERNAL* BCD 






CON 


; ; c ; B 5 A 








ENOM 










• 
• 

BASE 











CHAR 


43, 10 ♦ 10.30 








COW--'':",:; 


30101043 


CHAR 1 






FNDrr 




CHAR I 






CHAP 


4m- •ll«ll«3l« 


9 






CON ■ ■ ■ 


3Tl lil44:^\ : 


CHAR 1 










CHAR 1 






CHAP 


45*60»?0. 1 3 


■f 






CON :^ 


13?0604'a 


CHAR 1 






E N DM 




CHAR 1 






CHAR 


46*40 »40 ♦ lb 








con '"- 


15404046 


CHAR 1 






FN DM 




CHAR 1 






CHAR 


47,54,S4, I? 








CON 


I?54b447 


CHAR 1 






ENOM; 




CHAR 1 






CHAR 


S0»^1*61*17 


/ 






co^i 


176121S/ 


ChAR 1 






ENDM 




CHAR i 
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5.4.4 MACROE - EQUIVALENCED MACRO HEADER 



A MACROE pseudo instruction can be used instead of a MACRO instruction to notify the assembler to 
place the instructions forming the body of the macro in a table of macro definitions for assembly upon 
call, to place the macro name in the operation code table, and to save the list of parameter names so 
that actual parameters supplied in the macro call can be listed by name in any sequence in the macro 
call. 

The MACROE pseudo instruction has two forms: 
Format one: 



LOCATION 


OPERATION 


VARIABIE SUBFIEIDS 


mname 


MACROE 


parameters 



Format two: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




MACROE 


mname, parameters 



The blank location field identifies the second format. 



mname A legal name other than END, ENDD, IRP, LOCAL, or ENDM. It can be 

1-8 characters. A name that is identical to a PPU symbolic machine instruction 
name, pseudo instruction, or macro instruction already in the operation code 
table redefines the instruction. The most recent definition is the one that ^plies 
for the macro call. A redefinition causes an informative flag to be issued but the 
new definition holds. 

parameters Names of substitutable parameters. Unlike MACRO, the order in which names 

are listed does not determine the order in which parameters can occur in the 
macro call. Each name is 1-8 characters, the first of which must be alphabetic. 
A name cannot be END, ENDD, LOCAL, IRP, ENDM, or the same as a local 
symbol. A name that begins with a number, or a second or later occurrence of 
a parameter name in the list is Ignored. Any of the following special characters 
separate parameters in the list: 

+ -*/()$ = , or . 

These characters have no meaning other than as separators. A blank terminates 
the list of parameters. Also, any of these can be used to separate the mname 
from parameters in format two. 

The total number of unique parameter names and local symbols must not exceed 
63 for any one macro definition. 

Format one does not require parameters. 
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Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a fatal error flag and 
ignore the definition. 

The assembler ignores a blanlc parameter produced by two adjacent separators 
or by a separator at the end of the list. 

For an example of definition and calls, refer to Equivalenced Macro Call. 



5.4.5 EQUIVALENCED MACRO CALL 

A macro definition headed by a MACROE pseudo instruction can be called by an instruction of the 
following format: 



LOCATION 


OPERATION 


VA8IABL€ SUBFIEIDS 


sym 


mname 


Pj=a^,P2=a2,...,p^=a^ 



Name of MACROE definition 

Optional symbol. A s^-mbol in the location field causes the location counter 
to be forced upper. The symbol is then assigned the value of the location 
counter. A location field symbol on the first line in the definition that generates 
code is assigned the same address. If the location field of the macro call does 
not contain a symbol, the manner of the force upper is a function of the first- 
code-generating line in the macro expansion. 

An equivalenced parameter. Each p is the name of a substitutable parameter. 
The a^ is an actual parameter to be substituted for p.. The parameters need not 
be listed in the same order as they are listed on the MACROE instruction. 
Equivalenced parameters in the list are separated by commas and terminated 
by a blank. 

A null value is substituted for any parameter omitted from the list. 

When the first character of an actual parameter is a left parenthesis, the 
assembler considers all the characters between it and the matching parenthesis 
as an embedded parameter or as an iterative parameter. It is an iterative 
parameter when the substitutable parameter has been named in an IRP pseudo 
instruction (section 5.4.9, IRP). Otherwise, it is an embedded parameter. The 
assembler removes the outer pair of parentheses before substituting the enclosed 
character string in a line. Embedded parenthetical items must be properly 
paired. A parenthetical item can contain blanlcs and commas. 



mname 



sym 



p.=a. 
1 1 
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After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 

Processing of a location symbol and forcing upper of the first macro instruction depend on the MACROE 
form used for the definition. 

If the macro is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of generated code upper. The location field sjonbol 
is assigned the current value of the location counter. A location field (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using format two, that is, the macro name is in the variable field and the first 
parameter is a location argument, the location symbol of the call is substituted for the first parameter or 
location argument. The fact that this argument came from the location field rather than the variable field 
has no special significance in the macro expansion. After substitution, spacing between fields is the same 
! as it was before substitution. 



Example, format one: 



Location Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




11 


18 


30 


5007 

5007 00000000000000000001 

5010 00000000000000000000 

5011 00000000000000000005 

Example, format two: 
Location Code Generated 




SAM 


MACROE 
CON 
CON 
CON 

• 
• 

• 

SAM 

CON 
CON 
CON 
ENDM 


A,B»C 
A 

8 
C 

A=l ,C=5,B 
I 




= 

SAM 1 
SAM 1 
SAM 1 
SAM 1 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


2 00000000000000000001 


I 




11 


18 


30 






MACROE 

CON 

CON 

CON 

ENDM 

SAM 


SAH»XX*A»B» 

A 

B 

C 

A«1>B»2*C»3 


C 



5-26 



60492600 G 



5.4.6 OPDEF - DEFINE CPU OPERATION 



An OPDEF pseudo instruction notifies the assembler to place instructions in the body of the definition 
in a table of definitions for assembly upon call and place the instruction syntax in the operation code 
table. There is no way of removing the definition from the table. It can, however, be bypassed 
through redefinition, or disabled through PURGDEF. If the S3mtax duplicates a CPU instruction already 
in the table, the OPDEF definition takes precedence. 

Format: 



lOCATION 


OPERATION 


VARIABLE SU8FIELDS 


syntax 


OPDEF 


parameters 



syntax The syntax consists of a mnemonic operator and variable field descriptors. 

The mnemonic operator consists of two characters. The first can be any 
character except blank. The seccaid character can be a register designator: 
A, B, or X in which case the operation field of the opdef call is recog- 
nized as cAn, cXn, or cBn (c is a unique character; n is 0-7); or the second 
character can be any other character, in which case the operation field of 
the opdef call is recognized simply by a two-character mnemonic, such as 
EQ. 

The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
opdef call. It consists of none, one, two, or three of the following 22 subfield 
descriptors. Q represents an expression. An r represents a register letter 
(A, B, or X). A comma separates two descriptors; a blank terminates the 



syntax. 




void 


Q 


r 


rQ 


-r 


-rQ 


^l-'^2 




-^l-'^2 




^1 *^2 








-^1 % 


-r^^rgQ 


^l/^2 


rj /rgQ 


-^l/^2 




^r^2 


^1-^2^ 
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For example, -rj*r^ would be written as -X*B to describe -X3*B1 whereas rQ 
would be written as BQ to describe B2+ALPHA. The first descriptor immedi- 
ately follows the mnemonic operator. 

A substitutable parameter for each register designator (r) and expression 
parameters designator (Q) in the syntax in the order in which they occur in the syntax 

(and, consequently, in the calling instruction). Each name is 1-8 characters, 
the first of which must be alphabetic. A name cannot be END, ENDD, ENDM, 
IRP, LOCAL, or the same as a local symbol. A name that begins with a num- 
ber, or a second or later occurrence of a parameter name in the list is ignored. 
Parameters can be separated by any of the characters: 

+ -*/()$ = , or. 

These characters have no meaning other than as separators. A blank terminates 
the list of parameters. 

The total number of unique parameter names and local symbols must not exceed 
63 for any one OPDEF definition. 

The assembler ignores a blank parameter produced by two concurrent separators 
or by a separator at the end of the list. A second or later occurrence of a 
parameter name in the list is ignored. 

Examples: 

1. Listed below are some instructions that could be defined through OPDEF: 



Calling Instruction 


Opdef 


(Iteration 


Variable Subfields 


Syntax 


JPt 


Kti- 


JPQ 


JPt 


Bn+K 


JPBQ 


JP 


Bn+Bn+K 


JPB+BQ 


JP 


Bn,K 


JPB,Q 


JP 


Xn/Xn+K 


JPX/XQ 


NEt 


Bn,Bn,K 


NEB,B,Q 


LJ 


Bn-Bn,An-Xh,K 


LJB-B,A-X,Q 


BXht 


-Xh*Xn 


BX-X*X 


SBnt 


Xn+Bn 


SBX+B 


LXht 


Bn.Xh 


LXB,X 


JPt 


Bj+K 


JPBQ 


NEt 


Bj,Hc,K 


NEB,B,Q 


BXit 


-Xk*Xj 


BX-X*X 


SBit 


Xj+Hc 


SBX+B 


SBit 


Bj+Xk 


SBB+X 



t Legal COMPASS CPU Instructions 
tf K represents an expression. 



5-28 



60492600A 



2. The following complete definition redefines single- address long jump JP as the EQ jump, which 
is faster than JP on the 6600 Computer System. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




n 


18 |30 




JPQ 


OPOEF 


PI 1 






EQ 


PI 1 






FNOM 





Each subsequent JP instruction that matches the syntax JPQ is assembled as an EQ. A JP 
instruction having a different syntax, such as the following, is not affected. 



Location Code Generated 
lUCnZ 0233000005 ♦ 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




n 


18 


ho 






JP 


R34-ALPHft , 



3. The following definition traps all floating point double-precision subtraction instructions 

(DXi Xj-Xk) and jumps to an error-check routine for debugging. I, J, and K are substitutable 
parameters used within the definition. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


T 




11 


18 l30 




oxx-x 


OPOEF 

• 
• 

RJ 

ENDM 


I, J,K 

CKOUT 





4. The following sequence causes KXi K to be defined as AXi K. It does not affect the standard 
RXi instructions involving registers. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 l30 




RXQ 


OPOEF 


P1,P2 


1 






AX. PI 


P2 






ENDM 




1 
1 



5.4.7 OPDEF CALL 

An opdef call resembles a CPU mnemonic machine instruction. The mnemonic code, quantity and 
sequence of registers, arithmetic operators, and expressions (excluding operators within the expressions) 
must match the syntax described in the OPDEF for the definition to be called. 
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NOTE 



If the Q in a descriptor is combined with register letters, 
a plus or minus must precede an expression in the call. 



OPDEF Syntax Call 

JPQ JP K Not combined 

JPBQ JP Bn+K Combined 

JPB, Q JP Bn, K Not combined 

JPX/XQ JP Xn/Xn+K Combined 



An OPDEF call can occur any place after the definition is saved. In substituting parameters, the 
assembler uses only the register values given in the call. It does not substitute the register designators. 

A location symbol on the opdef call line forces the first word of generated code upper. The location field 
symbol is assigned the current value of the current location counter after the force upper, A location 
field on the line in the definition that generates code is assigned the same value. If the location field of 
the opdef call does not contain a sjrmbol, the manner of the force upper is a function of the first code- 
generating instruction in the expansion. If the call location field and the code -gene rating instruction 
field both contain symbols they are assigned the same value. 

Only a line having the correct syntax calls the definition. 

Examples: 

The following opdef defines an instruction having the syntax IXX/X. On the call, the assembler 
substitutes 3, 4, and DIV (not X3, X4, and X. DIV) for PI, P2, and P3, respectively. 



Location Code Generated 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




11 


18 


30 






ixx/x 


OPDEF 


Pi,P2,P3 












PX.P2 


X.P2 












PX.P3 


X.P3 












NX.P2 


X.P29B4 












NX.P3 


X.P3»B4 












FX. PI 


X.P2/X.P3 












UX.Pl 


X.Pl ♦B4 












LX.Pl 


X.Pl »B4 












ENQM 
• 














• 
• 

1X3 


X4/X.DIV 






27^04 






PX,4 X 


»4 




.1 


27000 






PX.OIV 


X.DIV 


1X3 


• 1 


27 2^444 






NX. 4 X 


»4?B4 


1X3 


.1 


24040 






NX. DIV 


X.DIV»B4 


1X3 


• 1 


44340 






FX,3 


X.4/X.UIV 


1X3 


• 1 


26343 






UX.3 X 


• 3»b4 


1X3 


-1 


30 22343 






LX.3 X 


.3»B4 


1X3 


.1 








ENOM 




1X3 


•I 
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The following OPDEF selectively traps the SXi Xj+Bk instructions. 



Definition: 





lOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


IS |30 


St 


SKK*8 
atements th 


OPOEF 
• 
• 
• 

ENOM 

at call thj 


I 9 J f K j 

3 definition: 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




11 


18 ho 


St 


atements th 


SX3 

• 

« 

• 

SX.NN 

at do not 


K6<-B.XXX 1 

call the definition: 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


J 




n 


18 iao 






SX5 
SX6 
SX.Y 
SY 


X«» INO B DESIGNATOR OR •«■. 
B3+X«» i'rEGISTERS INTERCHANGED 
33 INO X DESIGNATOR OR OPERAND 
Xk^Bk jHNEHONIC CODE NOT SX. 



5.4.8 LOCAL— LOCAL SYMBOLS 

One or more LOCAL instructions that list S5rmbols local to the definition optionally follows the MACRO, 
MACROE, or OPDEF pseudo instruction. The only lines that can separate the first header statement 
from LOCAL are comment lines. 

Format: 



LOCATION 


OPERATION 


VARIABLE SU8FIELDS 




LOCAL 


sjnnabols 



symbols List of local symbols. Each symbol must begin with an alphabetic character. 

Symbols must be separated by and must not include the following characters: 

+ -*/()$=, or . 
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A blank terminates the list. The assembler ignores a null symbol produced by 
two adjacent separators or by a separator at the end of the list. COMPASS ignores 
the use of a substitutable parameter name, another local symbol name, or a name 
beginning with a number in the local sym.bolUst. A local symbol cannot be END, 
ENDD, ENDM, ERP, or LOCAL. The total number of unique parameter names and 
local symbols must not exceed 63 for any one macro or OPDEF definition. 

A location field symbol, if present, is ignored. 

A symbol in the list is ccxisidered local to the macro; that is, it is known onl}' within the macro definition. 
Qi each ejqpansion of the macro, COMPASS creates a new symbol for each local symbol and substitutes it 
for each occurrence of the local symbol in the definition (other than in comment lines identified by * in 
column 1). Thus, invented symbols replace LOCAL- named symbols wherever they appear in a macro 
definition in a manner similar to the way substitutable parameters are replaced. The chief difference 
between substitutable parameters and local symbols is that COMPASS automatically supplies the value C 
(character string to be substituted for) a local symbol so that it is unique for each macro call. 

A user passes a local symbol to inner macro definitions or inner macro calls when he does not declare 
the symbol local in any of the inner definitions saved or called. That is, a ssnnbol declared Icxjal in a 
macro can be referred to in any inner macro that does not also declare it as local (see example 2). 

A symbol not defined as local is accessible from outside the macro definition. An invented symbol is 
qualified if defined while in a QUAL block. It is not listed in the symbolic reference table. Blanks 
are preserved in a line containing a substituted symbol; COMPASS makes no attempt to change the 
structure of the line. 

On ttie listing, each invented symbol is sho^^oi as tisym, where sym is unique for each local symbol in 
the subprogram. For example, if the symbol A is declared local to the macro, ihe subprogram can 
define a different symbol A elsewhere. 

Examples: 

1. In the following example, C is local to macro ABC and is passed to inner macro definitions. 
In the definition, each occurrence of formal parameter A is replaced by the parameter mark 
7701; each occurrence of B by the parameter mark 7702, and each occurrence of C by Uie 
parameter mark 7703. Then, when ABC is called, COMPASS assigns invented symbol 
♦♦000001 to C and replaces each occurrence of 7703 in definitions ABC and XYZ. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 lao 




ABC 
C 

• 
• 
• 

XYZ 

'^>^000001 
XYZ 


MACRO 

LOCAL 

BSS 

• 

• 

• 

MACRO 

SAl 

• 

ENOM 

ABC 

MACRO 

SAl 

ENDM 

1 


AtB 1 

C 1 
lOB 1 



C I joEFINITION 
|0F XYZ 

BSS 108 

t^OOOOOl ) DEFINITION 
J OF XYZ 


DEFINITION 
'of ABC 

EXPANSION ABC •! 
^ OF ABC ABC .1 

ABC .1 
ABC -l 
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2. 



Jn the following example, C is local to each level, 
preceding one. 



Note how this example differs from the 



lOCATION 



BCD 

C 
« 

YZA 



OPERATION 



HACRO 
LOCAL 

ess 



HACRO 
LOCAL 
SAI 



BSSZ 
ENOM 



VARIABIE 



COMMENTS 



30 



A«B 
C 

lOB 



DEFINITION 
OF YZA 



DEFINITION 

OF BCD 



On the call to BCD, the assembler replaces each occurrence of C with the invented symbol, 
fl000002 including the use of the symbol in the LOCAL instruction for macro XYZ. 





lOCATION 


OPERATION 


VARIAeiE 




COMMENTS 






! 




1) 


18 


30 








BCD 






EXPANSIOiN OF bCD 








I' 4-000002 




bSS 


108 




BCD 


• 




YZA 


MACHO 








BCD 


• 






LOCAL 


'^*000 


002 




BCD 


• 






SAI 


^^000002 


DEFINITION 


BCD 


• 




t*000002 




bSSZ 


i 




BCD 


• 






endm 








BCD 


• 



Finally, on a call to YZA, fK)00002 is defined as local and the assembler replaces each 
t*000002 with another invented symbol. Thus, each reference to C in the source code SAI 
instruction does not result in a reference to the BSS in tibe outer macro. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




n 


18 


30 




t'i'000003 


YZA 
SAi 

£NDH 


*+00000J 
bSSZ 1 


EXPANSION OF YZA 
DEFINITION 


YZA 
YZA 
YZA 



5.4.9 IRP - INDEFINITELY REPEATED PARAMETER 



An IRP pseudo instruction in a macro definition signals the beginning or end of a sequence of code to be 
assembled repeatedly with one parameter varied with each repetition. 



It has two formats : 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IRP 


parameter 




IRP 
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The first form introduces the sequence and names the substitutable parameter; the second form 
terminates the repeated sequence. In either form, a location field symbol, if present, is ignored. 

The parameter name must be listed as a substitutable parameter on the MACRO or MACROE pseudo 
instruction for the definition. 



On the macro call, the indefinitely repeated parameter consists of one or more subparameters enclosed 
by parentheses and separated by commas. The assembler assembles the sequence for each subparameter; 
the number of copies of the sequence depends on the number of subparameters (none at all when the 
actual parameter is null). When the list of subparameters is exhausted, the assembler continues with. 
the next line in the definition. If the named substitutable parameter does not occur between the two 
IRP instructions, the assembler repeats the code unchanged for each subparameter provided in the call. 
An IRP outside of the range of a macro has no effect 5n assembly other than to be included in statement 
counts, 

IF-skips of IRP sequences should be controlled by instruction bracket names rather than statement 
counts because IRP expansions are done even when an IF-skip is used and because the number of 
statements generated by IRP is variable. 

Anything that can be done with an IRP pair can be done with ECHO and ENDD. IRP is faster at assembly 
time but ECHO is more flexible (it is not expanded during IF-skips, allows multiple arguments, and 
can be nested). IRP should be used when greater speed is desired and the expanded capabilities of 
ECHO are not needed. 

Examples: 



1. Repeat sequence within macro 



ZA8 



?.2 

22 5110000000 

?3 5160000000 

?4 7P61000000 

25 5110000000 

?6 5160000000 



7261000000 

I 

51 10000000 



5160000000 



7261000000 



LOCATION 



OPERATION 



MACRO 

IRP 

SAl 

SX6 

SA6 

IRP 

ENDM 



ZAB 
IRP 
SAl 
SX6 
SA6 
SAl 
SX6 
SA6 
SAl 
SX6 
SA6 
IRP 



VARIABLE 



COMMENTS 



18 



30 



AR6,B 

ARG 

ARG 

X1*B 

ARG 



(J,K,L) ♦CON 

J*K,L 

J 

XI ♦CON 

J 
K 

XI ♦CON 

K 

L 

Xi*CON 
L 



REPEATED 
ISEQUENCE 



OEFINITieN 
OF ZAS 



ZAB 


• 1 


ZAB 


• 1 


ZAB 


.1 


ZAB 


• I 


ZAB 


• ! 


ZAB 


• 1 


ZAB 


• 1 


ZAB 


.1 


ZAB 


• 1 


ZAB 


• 1 


ZAB 


.1 


ZAB 


• 1 
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2. Assign symbol at every lOOg words of zeroed storage: 





tOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




n 


18 ho 
















1 1 c c 

Ubt 




STORAGE 








BUF 




n H rc u 




D 1 












IRP 




PI 








PI 




BSSZ 




lOOB 












IRP 
















ENOM 
















BUF 




(P,@,R,S»T) 












IRP 




PfQ^RsS*! 




y-rr":' ^^^^^ 




p 


F 


SSZ 


1 


OOB 




BUF 
BUF 







E 


ssz 


1 


008 






R 




ssz 


} 


008 




BUF 




S 


t 


ssz 


i 


OOB 








T 


t 


ssz 


1 


OOB 












IRP 








BUF 








ENDM 








BUF 



5.5 SYSTEM MACiO AND ©PDIF DiFIMITI0l4S 

Definitions of such general usefulness that they should be available to any program without each 
program defining them can be placed on the system text file as system macros or can be placed on 
a file accessible through an XTEXT pseudo instruction. 



System macros provide for such system functions as reading and writing files and specifying parameters 
for file environment tables, etc. Systems macro definitions are available to COMPASS for each 
assembly. The programmer can use a macro call for a system macro at any time in his program. 
Descriptions of system macros are given in the operating system reference manual. 

Systems definitions can include any legal macro or opdef definition. An expansion of a call for a 
system definition is not normally included on the assembler listing. Use of the S option of the LIST 
pseudo instruction( Section 4.11,1) enables listing of expansions of system definitions. 
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The COMPASS operation code table contains the information that COMPASS requires for interpreting 
legal operation field entries for COMPASS instructions. 

When assembly begins, the operation code table contains these entries: 

Pseudo instructions (except LOCAL) 
CPU sj^bolic instructions (Section 8. 4) 
CMU sjonbolic instructions (Section 8,5) 
PPU symbolic instructions (Chapter 9) 
System macro and opdef definitions 

The MACRO, MACROS, and OPDEF pseudo instructions (chapter 5) cause entries to be made in this 
table. In addition, the programmer has the capability of creating entries through the following 
instructions discussed later in this chapter: 

CPOP CPU operation 

PPOP PPU operation 

OPSYN Synonymous PPU or pseudo operation or macro 

CPSYN Synonymous CPU operation or opdef 

If a new entry redefines an instruction already in the table, the obsolete entry is not physically removed 
from the table. Instead, it is saved so that the table canbe reconstructed between assemblies. 
COMPASS reconstructs the operation code table using all the original system macros, opdef s, pseudo 
instructions, and symbolic machine instructions. No programmer- created entry is preserved from 
assembly to assembly. The number of entries in the table is limited to 4123. 

The only pseudo instructions that logically remove entries from the operation code table are PURGMAC 
andPURGDEF. 

Entries in the operation code table are in two distinct formats permitting a logical division of the 
table. One type of entry permits identification of an instruction by finding a match for the contents of 
the operation field, thus, it provides mnemonic recognition. The other type of entry is looked at only 
if the search for a mnemonic operator fails to yield a match during a CPU assembly. 

This type of entry provides for recognition of an instruction according to its syntax. COMPASS 
analyzes the statement to be interpreted, determines the syntax of the operation and variable subfields, 
and again searches the table. 
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Instructions recognized in the mnemonic search and the information provided to the assembler for 
each instruction are as follows: 



Pseudo instructions 



PPU symbolic instructions 



Instructions described through PPOP 



Macro instructions 



Instructions described through OPSYN 



The entry contains addresses to routines that perform 
pass one and pass two operations 

The entry describes the format of the instructions to 
be assembled 

The entry describes the format of the instruction to 
be assembled 

The entry directs the assembler to the location of the 
saved definition 

The entry is a copy of the synonymous entry 



For a PPU assembly, a failure to find an entry for a mnemonic operator causes an operation code error. 
For a CPU assembly, however, if the search for the mnemonic operator does not yield a match, 
COMPASS searches the operation code table again for an entry with a matching syntax. Instructions 
recognized in the syntactical search and the information provided to the assembler for each instruction 
are as follows: 



CPU symbolic instructions The entry describes the format of the CPU instruction 

to be assembled 

Instructions described through CPOP The entry describes the format of the CPU instruction 

to be assembled 

Instructions defined through OPDEF The entry directs the assembler to the location of the 

definition 

Instructions described through CPSYN The entry is a copy of the synonymous instruction 

The action taken depends on the synonymous entry 



If, following the second search of the operation code table, the statement still has not been identified, 
the assembler takes the following action: 

For a PPU assembly, it generates a 24-bit instruction of which the first 12 bits are zero. 
For a CPU assembly, it generates a 30-bit zero instruction. 

Although OPSYN and CPSYN pseudo instructions provide a means of rendering more than one 
instruction synonymous, only instructions of the same type can become synonymous. The logical 
division of the table between the two types of entries prevents mnemonically identified instructions from 
being made synonjmious with syntactically identified instructions. 

When a MACRO, MACROE, PPOP, or OPSYN creates an entry for a mnemonic name that is already 
in the table for a different instruction, the new entry takes precedence over the old entry. Similarly, 
when a OPDEF, CPOP, or CPSYN redescribes a syntax already in the table for a different instruction, 
the new entry takes precedence over the old entry. As a result, the order of precedence for operation 
field recognition is, from highest to lowest: 

1, Programmer-created entries for mnemonically identified instructions 
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2. System macros, pseudo instructions, PPU symbolic machine instructions, and CMU 
instructions other than the IM instruction. 

3. Programmer-created entries for syntactically identified instructions 

4. CPU symbolic instructions and the CMU IM instruction 
Example : 

The following example illustrates a special case in which a macro name takes precedence over one 
form of a machine instruction, i. e. , the form using SjB4 as an operation code. 



LOCATION 



OPERATION 



ENOW 



S83 



OPSYN 



VARIABLE 



COMMENTS 



30 



Pi,P2 



Al+ABLE 



A14-ABLE 



NIL 



PURGMAC SBh 



DEFINE MACRO NAHEO SB^» 



CALL TO MACRO. NOT CPU INSTRUCTION 



MACHINE INSTRUCTION 



DISABLES MACRO BUT DOES NOT 

RESTORE NORMAL USE OF S8£» 

AS AN OPERATION CODE. EVEN IF 

IT WERE REDEFINED WITH OPOEF 
IT WOULD MOT BE RECOGNIZED. 
THE MACRO FORM ALWAYS TAKES 
PRECEDENCE. 

RESTORES NORMAL USE OF S8^ 



6.1 MNEMONiCALLY IDENTIFiED INSTRUCTIONS 

Mnemonically identified instructions include all pseudo instructions, macro instructions, and PPU 
symbolic instructions whether system or programmer defined. PPOP, OPSYN, NIL, and PURGMAC 
provide the programmer with a means of creating or removing operation code table entries that are in 
the mnemonically identified format. 



6.1.1 PPOP - PPU OPERATION CODE 

The PPOP pseudo instruction defines the operation and variable fields of a PPU sjrtnbolic machine 
instruction and creates an operation code table entry for the instruction. COMPASS generates an 
octal machine instruction of the defined format whenever the PPU instruction described by the PPOP 
instruction is used. If the operation code table already contains an entry for the name, the new 
definition takes precedence over the old during assembly of the subprogram or until it is redefined. 
No error is flagged. Any illegal parameter in PPOP causes COMPASS to ignore the PPOP and issue 
a 7-type error flag. 
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Format: 



lOCATION 


OPERATION 


VARIABIE SUBFrElDS 


name 


PPOP 


ctl,val,type 



name Mnemonic name, 1-8 characters 

ctl Control of instruction assembly 

ctl Significance 

Illegal; if used, COMPASS ignores the PPOP 

1 24-bit instruction with 12-bit address and no indexing 

2 12-bit instruction with signed relative address or absolute address 
(e.g.,UJN) 

3 24-bit instruction with 18-bit address (e.g. ,LDC) 

4 12-bit instruction with 6-bit address (e. g. , LDN) 

5 24-bit instruction with 12-bit address and optional indexing 
(e.g., LDM) 

6 12-bit instruction with signed relative address (e, g. , SHN) 

7 24-bit instruction with 12-bit address and required second 
field (e.g. , lAM) 

val An evaluatable expression specifying the octal 4-digit operation code value; 

usually, only the two leftmost digits are significant. If the assembly base is M, 
the field is assumed to be octal. 

type An evaluatable expression specifying an integer value that COMPASS interprets 

as follows: 

6 Restrict the instruction being defined to the CYBER 170 Series, 
CYBER 70/Models 71, 72, 73, and 74; COMPASS sets an error 
flag if the instruction being defined is used in a CYBER 70/ 
Model 76 PPU assembly. 

7 Restrict the instruction being defined to the CYBER 70/Model 76; 
COMPASS sets an error flag if the instruction being defined is 
used in a CYBER 170 Series, CYBER 70/Model 71, 72, 73, or 
74 PPU assembly. 

other or The instruction is not restricted to either machine type, 

omitted If the base is M, type is assumed to be octal. If type is omitted, 

the comma preceding it can be omitted also. 
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Example: 



Code Generated 



0«»0 



1«5 

<»0 



7311 





LOCATION 


OPERATION j 


VAttABlE 


COMMENTS 




1 




11 1 


IS 


|30 








Per? 1 '-'H 

BfiSE 





-i 

I 
1 








c 




1 








• 




1 






C 

SIM 


FQU 

FQU 

PPQ9 

• 

« 

a 


15 
C 


1 
i 
1 
1 
\ 
\ 
1 





6.1.2 OPSYN - SYNONYMOUS MNEMONIC OPERATION 

The OPSYN pseudo instruction makes a name in the location field of the OPSYN synonymous with the 
macro, pseudo instruction or PPU mnemonic name specified in the variable field. The size of the 
operation code table is the only limit to the number of instructions that can be made synonymous. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


namej^ 


OPSYN 


name 2 



The name in the variable subfield must be previously defined as a standard instruction code. After an 
OPSYN, either name produces equivalent results. If the location field specifies a previously defined 
macro or operation code, the new definition takes precedence over the old without notification. Thus, 
a macro defined by a name that is subsequently used in an OPSYN location field is not called when 
the macro name is used in the operation field. The instruction actually called is the instruction 
named in the variable subfield of the OPSYN. On the other hand, the old macro definition is not lost 
and can be restored by purging the new definition with PURGMAC. 



Example: 



1. An operation named CALL is synonymous with RJM. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






1 




11 


18 ho 




CALL 


OPSYN 
• 


RJM 


1 

1 
1 
1 










• 

CALL 


=XSUBR= 


1 

'produces 
Ias if it 


SAHE 
WERE 


RESULTS 
AN RJH 
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2. Ill the following example, a programmer wishes to use a macro named LJM for part of the 
program and use the real LJM for the remainder of the program. 





lOCATION 


OPERATION 


VARIABIE 


COMMENTS 






11 


18 |30 






Uro T w 

PURGMAt 


LJM 

LJM 


SAVE ORIGINAL DEFINITION AS LJV 

PURGE ORIGINAL DEFINITION 

1 

1 




LJM 


MACRO 


XX 


1 
1 
1 
t 




LJM 


CNOH 




1 

i; 

> iCOOE USING LJM MACRO 




LJM 


OPSYN 


LJM. 


= IrESTORES ORIGINAL LJM 

1 

^ jCOOE USING ORIGINAL LJM 



6.1.3 NIL - DO NOTHING PSEUDO INSTRUCTION 

I^ie NIL pseudo instruction resembles a no-op; it produces no code and conveys no information to the 
assembler. It is primarily designed for disabling a macro; it cannot be used with CPSYN. The 
following instructions could be used in place of NIL as nil instructions: 

ENDM 
ENDD 
ENDIF 
IRP 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




NIL 





A location field symbol if present is ignored. 
Example: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


ho 




MACK 


OPSYN 
• 


NIL 


—\ ^ _= 




TAG 


• 

MACK 
• 


A,Bf6,73 
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The assembler interprets each call to MACK as a NIL instruction. TAG is not defined because it 
becomes the location field symbol for NIL when the statement is assembled. 



6.1.4 PURGMAC— PURGE MACROS 

The PURGMAC pseudo instruction provides a means of disabling operation code entries for the named 
instructions for the duration of the current assembly. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIOS 




PURGMAC 


namcj; ,name2, . . . ,nsm.e^ 



name. Names of mnemonic operation codes for macro definitions, pseudo instructions, 

or PPU instructions. 

A location field symbol if present is ignored. 
6.2 SYNTACTICALLY IDi^TIFiED INSTRUCTiONS 

Syntactically identified instructions apply to CPU assemblies only. The CPOP and CPSYN pseudo 
instructions create operation code table entries for instructions that are to be identified through 
recognition of their syntax, rather than through the contents of the operation field only. 

6.2.1 CPOP -CPU OPERATION CODE 

The CPOP pseudo instruction describes the syntax of a new CPU symbolic machine instruction and 
creates an operation code table entry for the instruction. An instruction of the defined format is 
generated whenever the CPU instruction described by the CPOP instruction is used. If the operation 
code table already contains an entry for the instruction, the new definition takes precedence over the 
old during assembly of the subprogram. Any illegal parameter in CPOP causes COMPASS to ignore 
the CPOP and issue an error flag. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sytx 


CPOP 


ctl, val,reg,type 



sytx The syntax consists of a mnemonic operator and variable field descriptors. 

The mnemonic operator consists of two characters. The first can be any 
character except blank. The second character can be a register designator: 
A, B, or X, in which case, the operation field of the instruction is recognized 
as cAn, cXn, or cBn, (c is a unique character; n is 0-7); or the second 
character can be any other character except blank, in which case the operation 
field of the instruction is recognized simply by a two-character mnemonic, such 
as EQ. 
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The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
instruction being described. It consists of none, one, two, or three of the 
following 22 subfield descriptors. Q represents an expression. An r represents 
a register letter (A, B, or X). A comma separates two descriptors; a blank 
terminates the syntax. 



void 


Q 


r 


rQ 


-r 


-rQ 










^^1*^2 












^l/^2 


r./r^Q 


-^l/^2 








^r^2 




-V^2 





For example, to describe -X3*B1, the descriptor, -rj^*r2, would be written as -X*B whereas, to 
describe B2+ALPHA, the descriptor rQ would be written as BQ. 

ctl Control of Instruction assembly. 



ctl Significance 

15-bit instruction 

1 30-bit instruction 

2 15-bit instruction, force upper before assembly 

3 30-bit instruction, force upper before assembly 

4 15 bit instruction, force upper after assembly 

5 30-bit instruction, force upper after assembly 

6 15-blt instruction, force upper before and after 

assembly 

7 30-bit instruction, force upper before and after 

assembly 
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val An evaluatable expression specifying a 9-bit operation code; if the base is M, 

val is assumed to be octal. 

reg Three octal digits specifying the order from left to right into which register 

numbers are to be inserted into the i, j, k portions of a 15-bit instruction, or 
into the i and j portions of a 30-bit instruction. If the assembly base is M, 
reg is assumed to be octal. 

1 Register number obtained from operation field 

2 Nimiber of second register or only register in 

variable field 

3 Number of first of two registers in variable field 
Set field to 



type An evaluatable expression specifying an integer value that CO]\IPASS interprets 

as follows: 

6 Restrict the instruction being defined to the 6000 Series, CYBEH 
170 Series and CYBER 70/Models 71, 72, 73, and 74; COMPASS 
sets an error flag if the instruction being defined is used when 
MACHINE 7 has been specified. 

7 Restrict the instruction being defined to the 7600 or the CYBER 70/ 
Model 76; COMPASS sets an error flag if the instruction being 
defined is used when MACHINE 6 has been specified. 



other The instruction is not restricted to a machine type, 
or 

omitted 

If base is M, type is assumed to be octal. If type is omitted, the comma 
preceding it can be omitted also. 

Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 




COMMENTS 








1 




n 


18 ho 






SAX+B 


CROP 


,5308, 


132B 


'DEFINES 


SAI 


XJ+BK 






SXXQ 


CPOP 

• 

• 


1,7203, 


1206 


,'defineis 


SXI 


XJ4-K 


53731 






• 

SA7 


X3fBl 










7231000003 




TAG 


SX3 


XH-3 
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6.2.2 CPSYN - SYNONYMOUS CPU INSTRUCTION 



The CPSYN pseudo instruction renders an instruction with the syntax given in the location field 
synonymous with the instruction having the syntax specified in the variable field. The only limit to 
the number of CPU instructions that can be made synonymous is the size of the operation code table 
(4123 entries). 

Format: 



lOCATION 


OPERATION 


VARiABlE SUBFIELDS 


sytx^ 


CPSYN 


sytXg 



sytx Syntax of a CPU instruction (see CPOP for legal forms). If this syntax is 

already in the operation code table, the table entry for sytx^ takes precedence 
over the old table entry for sytx^ without notification. 

sytx^ Syntax of a CPU instruction for which there must be an entry in the operation 

code table. Following the CPSYN, an instruction in either sytx^ or sytx2 
produces an octal instruction of the format described by the entry for sytXg. 

6.2.3 PURGDEF — PURGE CPU OPERATION CODE 

The PURGDEF pseudo instruction provides a means of disabling syntactically-identified operation code 
entries for the duration of the current assembly. 

Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




PURGDEF 


sytx 



sytx Syntax of a CPU instruction (see CPOP for legal forms). 

A location field symbol, if present, is ignored. 
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The COMPASS mic];-© capability enables the programmer to sj^mbolically refer to a defined character 
string. When used in conjunction with IFC, DUP, STOPDUP, and SET pseudo instructions, micro 
strings provide for varied manipulation of character strings ~ testing for a particular character, 
counting characters, concatenation of strings, etc. 

Use of a micro definition requires two steps: definition of the character string, and substitution. In 
this discussion, substitution rather than definition is discussed first so that the reader has a better 
understanding of how a definition is used when it is described. 

7.1 .mi«© SUiSTITyTiON 

Wherever a micro name between micro marks {^) occurs in a statement other than a comment 
line {* In column 1), the assembler substitutes the micro before it interprets the statement. If 
column 72 of the last statement read is exceeded as a result of micro substitution, the assembler creates 
up to a maximum of 9 continuation statements, beyond which it discards excess characters without noti- 
ficatim on the listing. No replacement takes place if the micro name is unknown or if one of the micro 
marks has been omitted. If the micro name is unknown, the assembler flags a nonfatal assembly error. 
If the micro name is null (that is, the two micro marks are adjacent), then 

1. Both micro marks are deleted, and 

2. No error flag is set 
Example: 

A micro identified as NAM is defined as the 7 characters: 
ADDRESS 

A reference to NAM is in the variable field of a Hue: 





lOCATION 


OPERATION 


VAglABlE 


COMMENTS 


1 




n 


18 


30 




LOC 


Sit 







However, before the line is interpreted^ COMPASS substitutes the definition for NAM producing the 
following line : 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 






11 


18 lao 




LOC 


SAi 


ADDRESS*** 1 



NOTE 

Unless the A option of the LIST pseudo instruction is 
enabled, the listing depicts the instruction as it was 
before the substitution took place. 
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7.2 miC^O DEFiHiTION 



Pseudo instructions specifically designed for the purpose of defining micros are: MICRO, OCTMIC and 
DECMIC. In addition, the following pseudo instructions optionally define micros: BASE, CODE, and 
QUAL. Also, system or built-in micros are automatically defined by COMPASS at the start of each 
subprogram assembly. 

7.2.1 MICRO - DEFINE MICRO 

The MICRO pseudo instruction defines a character string and assigns a name to that string. 
Format: 



lOCATION 


OPERATION 


VARIABLE 


SUBFIEIDS 


micname 


MICRO 




dstringd 



micname 



dstringd 



Name by which definition is called; 1-8 characters 

Absolute evaluatable expression specifying starting character in string; when the 
base is M, COMPASS assumes that n^ is decimal. 

Absolute evaluatable expression specifying number of characters; when the base 
is M, COMPASS assumes that n^ Is decimal. 

Delimiited character string. The delimiter d is a character not used in the 
string. 



Countir^ the first character after d as character 1, the assembler forms the string by extracting Ug 
characters starting with character n^. If the second delimiting character occurs before count Ug is 
exhausted, the defined string terminates at that point. If n^ is greater than zero and n2 is omitted, zero^ 
or negative, the defined strii^ includes all the characters from n^ to the closing delimiter (see second 
example). 

Jin^ is omitted, zero, or negative, the defined string is empty; no substitution takes place when the micro 
name is referred to. That is, ng and the character string are ignored, 

A previously defined micro can be a part of a micro definition; one micro can be defined as a substring 
of another (see third example). 

A micro can combine previously defined micros or can be a subset of another. Also, a micro defined 
originally as one character string can be redefined subsequently with a different character string. After 
the redefinition, the original character string is inaccessible. 

If nj^ or n2 is negative, the assembler generates a 7-type error, 
Examples: 

1. The following MICRO defines NAME as the 19 characters beginning with A and ending with G. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


bo 












NWE 


HICRO 


1,19, 


♦ALPHANUMERIC STRING* 
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2. This CKa^nple iUustrate. a blank character count. The defined string begins with A and is 
terminated by the closing delimiter. 



LOCATION 



HICKY 



OPERATION 



MICRO 



VARIABLE 



COMMENTS 



30 



1, , ♦ALPHANUMERIC STRING* 



3. One micro can 



be defined as a substring of another. 



LOCATION 



NAM! 



NAM2 



OPERATION 



MICRO 



MICRO 



VARIABLE 



COMMENTS 



1 30 



J^Y^TmOoR^LPHANUHERIC STRING* 



r,,*#NAMl#* iSAME STRING AS IN EXAMPLES 1 AND ? 



4. One micro can combine others. 



LOCATION 



NAHl 
NAM2 
NAM3 



OPERATION 



MICRO 

MICRO 
MICRO 



VARIABLE 



COMMENTS 



30 



l,i25SALPHANUMERIC? 

i:':jNA^lJ^NAM2*. COHBINES NAMl AND NAM2 



5. A micro name can be redefined. 



LOCATION 



MSG 



MSG 



OPERATION 



VARIABLE 



COMMENTS 



MICRO 



MICRO 



30 



1,6,'^STRING'^I 



ICODE USING FIRST DEFINITION 



1,19,*ALPHANUMERIC #MSG#* 



'code using SECOND DEFINITION. 
IfIPST definition is INACCESSIBLE. 



u f ^« o 1^ assembled or examined for syntax. Thus, 
6. Micro substitution takes place before a Ime is assembiea 

the following is possible. 



LOCATION 



OPERATION VARIABLE 



COMMENTS 



30 



NAM 



NAM#1 
LCC 



MICRO 



SAl 



ii25,» LOG 



A00RESS4-i 



SAl ADDRESS** 
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7.2.2 DECMIC - DECIMAL MICRO 



Using a decimal conversion, the DECMIC pseudo instruction converts the expression into a character 
string to be saved under the name specified. 



Format: 



lOCATlON 


OPERATION 


VARIABLE SUBFIEIDS 


micname 


DECMIC 


aexpsH 



micname Name by which definition is called; 1-8 characters 

aexp Absolute evaluatable expression 

n Optional absolute evaluatable expression specifying number of characters 

in the defined string. The defined string is a maximum of 10 characters 
regardless of the magnitude of n. When base is M, COMPASS assumes that 
n is decimal 



If n is omitted or has a zero value, the micro contains the number of characters 
indicated by the conversion to a maximum of 10 characters. If the converted 
expression has more than n (or 10) digits, the most significant digits are 
truncated. If the value has fewer than n digits, the string is right justified and 
filled with leading zeros. All numbers are treated as positive. 

Example: 

B has tiie value 1024 decimal or 2000 octal before conversion. 





lOCATION 


OPERATION 


VARIABLE COMMENTS 


» 




It 


18 |30 




V 


DECHir: 






SYMBL 
SYMBL 


MTCPC 
MIC»0 


t 

1 , ,»<V* STORAGE NEEDED* 
l,»*30iQ?'* STORAGE NEEDED* 



7.2.3 OCTMIC - OCTAL MICRO 

Using an octal conversion, the OCTMIC pseudo instruction converts the value of the expression into a 
character string to be saved under the name specified. 
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Format: 



tOCATtON 


OPERATION 


VARIABLE SUBFIELOS 


micname 


OCTMIC 





micname Narfie by which definition is called; 1-8 characters 

aexp Absolute evaluatable expression 

n Optional absolute evaluatable expression specifying number of characters 

in the string. The defined string is a maximum of 10 characters regardless 
of the magnitude of n. When base is M, COMPASS assumes n as a decimal. 
If n is omitted or has a zero value, the micro contains the number of 
characters indicated by the conversion to a maximum of 10 characters. 

If the converted expression has more than n (or 10) digits, the most significant digits are truncated. 
If the value has fewer than n digits, the string is right justified and filled with leading zeros. All 
numbers are treated as positive. 

Example: 



B has the value 1024 decimal or 2000 octal before con version. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




n 


18 Uo 








1 . 1_ 




VI 


OCTMIC 


8,6 1 




51 


MICRO 
HTCRO 


t 

1,,*#V1# ADDITIONAL STORAGE NEEDED* 
1,,*QQ2Q00- ADDITIONAL STORAGE NEEDED* 



7.3 PREDEFINED MICRO NAMES 

Several standard micros are predefined by the COMPASS assembler. They are available for every 
assembly. The programmer simply writes the micro reference as desired. 

These micros are automatically defined at the beginning of each assembly, and have the default values 
specified below until they are redefined by the programmer; thereafter, the programmer's definition 
holds until the start of the next assembly. 

7.3.1 DATE 

The DATE micro contains the current date in 10 characters in one of the following forms as obtained 
from the operating system: 

Ayr/mo/dy, or Amo/dy/yr. 
The micro reference is t^DATE?^, 
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7.3.2 JDATE 



The automatic value of the JDATE micro is five digits yyddd, where yy is the year and ddd is the day 
of year at the time of assembly. Thus, JDATE is the Julian date form of DATE, 

The micro reference is 9^JDATE5^. 
7.3.3 TIME 

The TIME micro contains the current time of day in 10 characters in the following form as obtained 
from the operating system: 

Ahr.min. sec. 

The micro reference is t^TIME?^* 
Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




11 


18 [30 














TITLE 


PROGRAH ^SSEHSLEO ON tQAltt hltlintt 



7.3.4 BASE 

The automatic value of the BASE micro is a single letter D, M, or O, corresponding to the number 
base currently in effect (specified by the most recent BASE pseudo instruction); it is initially D. 

The micro reference is t^BASEt^. 

7.3.5 CODE 

The automatic value of the CODE micro is a single letter A, D, E, O, or I, corresponding to the 
character code currently in effect {specified by the most recent CODE pseudo instruction); it is 
initially D. 

The micro reference is t^CODE?^. 

7.3.6 QUAL 

The automatic value of the QUAL micro is to 8 characters comprising the qualifier symbol 
currently in effect (specified by the most recent QUAL pseudo instruction); it is null initially and 
whenever the blank qualifier is in effect. 

The micro reference is t^^UAL?^, 
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7.3.7 SEQUENCE 

The automatic value of the SEQUENCE micro is 18 characters comprising the sequence field 
(columns 73-90) of the first line of the COMPASS source statement most recently read from the main 
source input file. Thus, if the current statement was read from the main source input file, SEQUENCE 
is the sequence field of the first line of the statement. However, if the current statement is generated 
(i.e. , part of a macro call expansion, DUP expansion, etc. ) or is read from a different file via the 
XTEXT pseudo instruction, then SEQUENCE is the sequence field of the first line of the statement most 
recently read from the main source input file. 

The micro reference is j^SEQUENCE?^. 



7.3.8 MODLEVEL 

The automatic value of the MODLEVEL micro is the value (up to 9 characters) specified by the ML pa- 
rameter on the COMPASS control statement. If no ML parameter is present, the automatic value of the 
MODLEVEL micro is equal to that of the JDATE micro. When COMPASS is called by a compiler to 
process embedded COMPASS subprograms, the automatic value of the MODLEVEL micro is supplied 
by the calling compiler. The MODLEVEL micro is intended to be used when assembling a compiler 
(or COMPASS itself), to provide the compiler modification level to be placed in word 6 of each PRFX 
table in the binary output written by the compiler. 

The micro reference is j^MODLEVEL?^. 



7.3.9 / PCQMMENT 

The automatic value of the PCOMMENT micro is the value specified by the PC parameter on the 
COMPASS control statement, with ciiaracters truncated from the right or blanks appended to the right, as 
necessary, so that the micro's length is exactly 30 characters. If no PC parameter is present, the auto- 
matic value of the PCOMMENT micro is 30 blanks. When COMPASS is called by a compiler to process 
embedded COMPASS subprograms, the automatic value of the PCOMMENT micro is supplied by the call- 
ing compiler. The PCOMMENT micro is intended to be used in a COMMENT pseudo instruction to 
specify words 8 through 10 of the PRFX table in the binary output. It may also be used, in conjunction 
with the *F special symbol, to determine compiler options (debug mode, rounded arithmetic, etc.) in 
effect at the time of assembly. 

The micro reference is t^PCOMMENTj^. 



60492600A 



7-7 



CPU SYMBOLIC MACHINE INSTRUCTIONS 



8 



COMPASS recognizes symbolic notation for all CYBER 170 Series Central Processor Unit (CPU) 
instructions, all CYBER 70 Series Central Processor Unit instructions, all 7600 Central Processor Unit 
instructions, and all 6000 Series Computer Systems Central Processor Unit instructions. 

The assembler identifies each symbolic instruction according to its syntax and generates a one-parcel 
15-bit instruction or a two-parcel 30-bit instruction. The object code for an instruction is generated in tne 
block in use when the instruction is encountered. 

8.1 MACHINE INSTRUCTION FORMATS 

Figures 8-1 and 8-2 illustrate the formats for CPU 15-bit and 30-bit instructions generated by the 
assembler. 



fm 


i 


j 


k 



14 08 05 02 00 

Figure 8-1. CPU 15-Bit Instruction Format 



fm 


i 


j 


i K 

1 


29 


23 


20 


17 14 




00 



Figure 8-2. CPU 30-Bit Instruction Format 



fm 

fmi 

i 

j 
k 
K 



6-bit instruction code 
9-bit instruction coae 

3-bit code (0 through 7) specifying one of eight designated registers (for example, Ai) 
3-bit code (0 through 7) specifying one of eiglit designated registers (for example, Bj) 
3-bit code (0 tlirough 7) specifying one of eight designated registers (for example, Xk) 
18-bit integer value used as an operand, address of an operand, or branch destination address 
6-bit integer value specifying a shift count or mask count 



Figure 8-3 illustrates possible arrangements of one- and two-parcel instructions in a 60-bit CPU instruction 
word. Generally, the assembler does not allow a two-parcel instruction to begin in the fourth parcel of a 
word. 
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First Second Third Fourth 

Parcel (Parcel 0) Parcel (Parcel 1) Parcel (Parcel 2) Parcel (Parcel 3) 



15 


15 


15 


15 


59 




44 




29 




14 


00 


30 


15 


15 


59 










29 




14 


00 


15 


30 


15 


59 




44 








14 


00 


15 


15 


30 



59 



44 



29 



00 



30 



30 



59 



29 



00 



Figure 8-3. Arrangements of Instructions in a 60-bit CPU Word 



When a two-parcel instruction begins in the last parcel of a word, the CYBER 170/Model 175, 176, 740, 
750, or 760, and the CYBER 70/Model 76 or 7600 executes it as if the instruction word had a fifth parcel 
containing aU zeros. On the CYBER 170/Model 171, 172, 173, 174, 720, or 730, and the CYBER 70/Model 
71, 72, or 73, or 6400, this condition causes an error exit. On the 6600 or CYBER 70/Model 74, the CPU 
takes the first parcel of the current instruction. 

Before it assembles an instruction that must begin in the first parcel (forced upper) and after it assembles 
an instruction that requires the instruction following it to be forced upper, the assembler completes a word 
as follows: 

• Lower 15 bits remain They are packed with a one-parcel NO (pass) instruction. 

• Lower 30 bits remain They are packed with a two-parcel SBO BO+K instruction. 

• Lower 45 bits remain They are packed with a NO instruction and an SBO BO+K instruction. 



8.2 INSTRUCTION EXECUTION 



8.2.1 6600/6700^ AND CYBER 70/MODEL 74 EXECUTION 

After an exchange jump start by a peripheral processor unit \.PPU) and CPU program, CPU instructions 
issue automatically in the original sequence, to an 8-word instruction stack. The stack can hold a program 
loop consisting of up to twenty-six 15-bit instructions and one 30-bit instruction. 

Instructions are read from the stack, one at a time, and issued to the functional units (table 8-1) for 
execution. A scoreboard reservation system in CPU control keeps a current log of which units and 
operating registers are reserved for computation results from functional units. 



The 6700 also includes a 6400-type central processor unit 



8-2 
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TABLE 8-1. CYBER 70/MODEL 74 AND 6000/7600 FUNCTIONAL UNITS 



Unit 


flpnpi'Ql Function 


Branch 


Handles all jumps or branches from the program. 


Boolean 


Handles the basic logical operations of transfer, logical product, 
logical sum, and logical difference. 


Shift 


Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and normalize, pack, and 
unpack floating point operations. The unit also includes a mask 
generator. 


Floating Add 


Performs single or double precision floating point addition and 
subtraction on floating point operands. 


Long Add 


Performs addition and subtraction of two 60-bit fixed point operands 


Floating Multiply 


Performs single or double precision floating point multiplication on 
floating point operands 


Floating Divide 


Performs single precision floating point division of floating point 
operands; also counts the number of 1 bits in a 60-bit word. 


Increment 


Performs one's complement addition and subtraction of 18-bit operands. 



Each functional unit executes several instructions, but only one at a time. Some branch instructions 
require two units, the second unit receives direction from the branch unit. 

The rate of issuing instructions varies from the maximum of one instruction every 100 nanoseconds 
(one minor cycle). Sustained issuing at this rate may not be possible because of functional unit and CM 
conflict or because of serial rather than simultaneous operation of units. Program run time can be 
decreased by efficient use of the units. Instructions that are not dependent on previous steps may be 
arranged or nested in program areas where they may be executed concurrently with other operations to 
eliminate dead spots in the program and increase the instruction issue rate. 

The following steps summarize instruction issuing and execution: 

• An instruction is issued to a function unit when: 

Specified functional unit is not reserved. 

Specified result register is not reserved for a previous result. 

• Instructions are issued to functional units at minor cycle intervals when no reservation conflicts 
are present. 

• Instruction execution starts in a functional unit when both operands are available. Execution is 
delayed when an operand is a result of a previous step which is not complete. 

• No delay occurs between the end of a first unit and the start of a second unit which is waiting for 
the results of the first. 
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• After a branch instruction no further instructions are issued until instruction has been executed. 
In the execution of a branch instruction, the branch unit uses: 

Increment unit to form the instructions that branch to K + Bi and branch to K if Bi . . . 

Long add unit to perform the instructions that branch to K if Xj . . . 

Time spent in the long add or increment units is part of total branch time. 

Read central memory access time is computed from the end of increment unit time to the time an 
operand is available in X operand register. Minimum time is 500 nanoseconds assuming no central 
memory bank conflict. 



8.2.2 CYBER 170/MODELS 171, 172, 173, 174, 720, 730, AMD THE CYBER 70/ 
MODELS 71, 72, 73 AND 6200/6400/6500 EXECUTION 

The CYBER 170/Models 172, 173, 174, 720, and 730, and the CYBER 70/Models 71, 72, and 73, and 6200, 
6400, and 6500 systems CPU has a unified arithmetic unit, rather than separate functional units as in tne 
6600 system. Instructions in the CPU are executed sequentially. 

For efficient coding in the central processor unit: 

Always attempt to place jump instructions in the upper portion of the instruction word to avoid both 
the additional time for RNI (read next instruction, 2 minor cycles) and the possibility of a memory 
bank conflict with (P + 1). 

Where possible, place load/store instructions in the lower two portions to avoid lengthening 
execution times. 

Reading the next instruction words of a program from central memory, RNI, is partially concurrent 
with instruction execution. RNI is initiated between execution of the first and second instructions of the 
word being processed. Initiating RNI operation requires two minor cycles; the remainder of the RNI 
is parallel in time with execution of the remaining instructions in the word: 



Initiate 
RNI 




2ao 

nsec 



Execution of 
instructions 
2 and 3 



RNI 
-minimum of 
800 nsec 



Total RNI time 
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In calculating execution times, two minor cycles are added to each instruction word in a program to cover 
the RMl initiation time. Exceptions are the return jump and the jump instructions (in which the jump 
condition is met) when they occupy the upper position of the instruction word. Since the times for these 
instructions already include the time required to read the new instruction word at the jump address, no 
additional time is consumed. 

Example: 



p 


Jump to K (met) 


Pass 


Pass 












K 


Add 1 


Add 2 


Load 


Store 



Instruction 

Jump 
Add 1 

RNI Initiation 
Add 2 
Load 
Store 

Total Time 



Minor Cycles P>equired 

13 

5 

2 

5 
12 
10 

47 minor cycles 



After RNI is initiated (between the first and second instructions of the word), a minimum of eight minor 
cycles elapses before the next instruction word is available for execution. Even if the lower order positions 
of the word should require less than eight minor cycles, a minimum of eight minor cycles is allowed. 

Example: 



Jump to K 
(not met) 



Pass 



Pass 



P + 1 



8.2.3 CYBER 170/MODELS 175, 176, 740, 750, AND 760 AND THE 
CYBER 70/MODELS 76, AND 7600 EXECUTION 

Execution of an arithmetic or logical machine instruction takes place in one of nine functional units in the 
computation section of the CYBER 170/Models 175, 176, 740, 750, or 760 and the CYBER 70/Modeis 76 or 
7600 CPU. Each is a specialized unit with algorithms for a portion of the CPU instruction execution. 
Table 8-2 lists the general function of each unit. A number of functional units can be in operation at the 
same time. 
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TABLE 8-2. CYBER 170/MODELS 175. 176. 740, 750. AND 760 AND THE CYBER 70/MODEL 76 

AND 7600 FUNCTIONAL UNITS 



Unit 


General Function 




Handles the basic logical operations of transfer, logical product, logical 
sum, and logical difference. It also performs the pack and unpack 
floating point operations. 


Shift 


Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and mask generation. 


Normalize 


Performs the normalize operations. 


r lodtiug /iuu 


Performs single or double precision floating point addition or subtraction 
on floating point operands. 


Long Add 


Performs integer addition or subtraction of two 60-bit fixed point 


Floating Multiply 


Performs single or double precision floating point multiplication on 
floating point operands. 


Floating Divide 


Performs single precision floating point division of floating point 
operands. 


Population Count 


Counts the number of 1 bits in a 60-bit word. 


Increment 


Performs one's complement addition and subtraction of 18-bit operands. 



A functional unit receives one or two operands from operating registers at the beginning of instruction 
execution and delivers the result to the operating registers after performing the function. The functional 
units do not retain any information for reference in subsequent instructions. The units operate in three- 
address mode with source and destination addressing limited to the operating registers. 

Except for the floating multiply and divide units, all functional units have one clock period segmentation 
This means that the information arriving at the unit, or moving within the unit, is captured and held 
m a new set of registers at the end of every clock period. It is therefore possible to start a new set 
of operands for unrelated computation into a functional unit each clock period even though the unit may 
require more than one clock period to complete the calculation. This process may be compared to a 
delay hne m which data moves through the unit in segments to arrive at the destination in the proper 
order but at a later time. All functional units perform their algorithms in a fixed amount of time. No 
delays are possible once the operands have been delivered to the front of the unit. 

The floating multiply unit has a two clock period segmentation. Operands may enter the multiply unit 
m any clock period providing there was no multiply operation initiated in the preceding clock period. 

The floating divide unit is the only functional unit in which an iterative algorithm is executed There is 
little segmentation possible in this unit. However, to increase execution speed, the beginning of a new 
dmde operation can follow a previous divide operation by 18 clock periods for a gain of 2 clock periods. 

Instructions involving storage references for operands or program branching are difficult to time 
Program branching within the instruction stack causes no storage references and small program loops 
can therefore be precisely timed. 
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8.3 OPERATiNO REGISTERS 

Twenty-four registers minimize memory references for arithmetic operands and results: 



Function 


Identity 


Length 


Number 


Operand Registers 


XO - X7 


60 Bits 


8 


Address Registers 


AO - A7 


18 Bits 


8 


Index Registers 


BO - B7 


18 Bits 


8 



A register is reserved if it is the destination of an instruction that has been initiated but has not been 
completed. A register is free in the clock period (or minor cycle) following the store into it. 

8.3.1 X REGISTERS 

Eight 60-bit X registers in the computation section of the CPU designated XO, XI, . . . ,X7 are the 
principal data handling registers for computation. Data flows from these registers to the SCM (CM) 
and the LCM (not ECS). Data also flows from SCM (CM) and LCM (not ECS) into these registers. 
All 60-bit operands involved in computation must originate and terminate in these registers. 

Operands and results transfer between SCM (CM) and these registers as a result of placing SCM (CM) 
into corresponding address registers. 

On the CYBER 170/Model 176, CYBER 70/Model 76 and 7600, the X registers also serve as address 
registers for referencing single words from LCM. XO is used as the LCM relative starting address 
in a block copy operation. 

8.3.2 A REGISTERS 

Eight 18-bit A registers in the computation section of the CPU, designated as AO, Al, . . . , A7, are 
essentially SCM (CM) operand address registers. With the exception of AO and XO, A registers are 
associated one-for-one with the X registers. Placing a quantity into an address register Al - A5 
causes an immediate SCM (CM) read reference to that relative address and sends the SCM (CM) word 
to the corresponding operand register XI - X5. Similarly, placing a value into address register A6 
or A7 causes the word in the corresponding X6 or X7 operand register to be written into that relative 
address of SCM (CM). 

Tii. AO and XO registers operate independently of each other and have no connection with SCM (CM). 
AO IB used as the relative SCM (CM) starting address in a block copy operation and for scratch pad or 
intermediate results. 



8.3.3 B REGISTERS 

Eight 18-bit B registers in the computation section of the CPU designated as BO, Bl, . . . ,B7 are 
primarily indexing registers for controlling program execution. Program loop counts can be incremented 
and decremented in these registers. 
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Program addresses may be modified on the way to an A register by adding or subtracting B register 
quantities. The B register also holds shift counts for pack and normalize operations and the channel 
number for channel status requests. 

BO always contains positive zero; that is, BO is held clear. Often as a programming convention, Bl 
or B7 contains positive 1. See the Bl=l, the B7=l, and the R= pseudo instructions. 

8.4 SYMBOLIC HOTATiON 

This section describes notation used for coding symbolic CPU machine instructions. Instructions are 
listed according to octal sequence. Instructions unique to a computer system are identified as such. 
These instructions can be assembled on any machine but will execute properly on the noted machine only. 
For details and special conditions arising during instruction execution, refer to the relevant hardware 
system reference manual. 

The location field of a symbolic machine instruction optionally contains a location symbol. When the 
symbol is present, it is assigned the value of the location counter after the force upper (if any) occurs. 

The operation field of a symbolic CPU machine instruction contains a mnemonic operator, the last two 
characters of which are often a register designator. 

The variable field contains one, two, or three subfields. For 15-bit instruction, subfields take the 
forms: 

^ \ 

-r > r is a register designator 



r,r 

r op r 
-r op r 



op is a register operator + - * / 



+3k 



jk is an absolute expression specifying a shift count or mask bit count. If 
the expression value is in the range -60 to -0, inclusive, COMPASS adds 60 to it. 
If it is less than -60 or greater than 63, COMPASS sets a warning flag and uses 
the low- order 6 bits of the expression value. 



For a 30-bit instruction. 



subfields take the forms: 



K 



r op K 



The single subfield contains an absolute, relocatable, or external expression 
that does not include a register. 

The single subfield contains an absolute, relocatable, or external expression 
that includes a register designator; op is an expression operator: 



r,K 



r,r,K 



+ - * / 

One subfield contains a register designator, the other subfield contains an 
absolute, relocatable, or external expression that does not include a register 
designator. 

Tv/o subfields contain register designators; a third contains an absolute, 
relocatable, or external expression that does not include a register. 
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In the formats and examples, K reduces to an 18-bit value that represents one of the following in pass 
two: 

e An absolute address or a word count 

• An external symbol + an integer value 

• An address that is relocatable relative to the program origin or common block origin. 

• An address of a literal 

If K is negative, the assembler inserts the one's complement of the integer value in the K portion of the 
instruction. 

In the descriptions of the formats, +K designates that the evaluation of all nonregister elements can 
result in a positive or negative value for the expression (see section 2. 8. 2 Evaluation of Expressions). 
Use of ±K to represent the integer portion of the expression does not imply that the first term oper- 
ator in the expression is an expression operator. If you consider that a and b are terms in expression 
K, then +K indicates that the sum of the values of a and b is positive and -K indicates that the sum of 
the values is negative. Thus, -K does not mean that a-b would become -a+b. 

In the following example, the symbol XRAY has the value 407^. The first term operator (-) forms the 
value 777370 . Subtracting 1 from this results in 777367 or a -K (-410 ). 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




It 


18 1 30 


13 7212777367 






sxi 


. 1 

X2-XRAY-1 1 
I 



Unless otherwise noted, subfields can be in any order, COMPASS also allows an added degree of 
flexibility by allowing the variable subfields of an instruction to be written in the operation field with 
each subfield preceded by a comma. For example; 



Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 ho 














UXl 





can be written 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




n 


18 


ho 








tlXl, f^? 


X3 1 ■ 



The instructions are identical to the assembler. 
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Similarly, the following instructions are regarded as identical. Use of this feature is optional. 





lOCATiON 


OPERATION 


VARIABIE COMMENTS 


1 




n 


18 (30 








53, K j 



8.4.1 PROGRAM STOP OR EXCHANGE JUMP INSTRUCTION 

(CYBER 170 SERIES, CYBER 70/MODEL 71,72,73,74, AND 6000 SERIES) 

The CEJ/MEJ Panel Switch determines whether this instruction causes the central processor unit to 
halt or to execute an exchange jump. The DISABLE position disables the central exchange jump or 
the monitor exchange jump. In this case, the instruction is illegal for a CYBER 170/Model 175. For 
all other systems, PS halts the central processor unit at the current step in the program. An exchange 
jump is necessary to restart the central processor unit. The ENABLE position enables the jump capa- 
bilities for all systems. In this case, PS causes an exchange jump to monitor address (MA) in the 
exchange package. For the CYBER 170/Model 176, the CEJ/MEJ switch is ignored; exchange jumps 
are always enabled. For 6000 series systems, the CEJ/MEJ switch is ignored; PS always causes the 
central processor unit to halt. The job continues to hold a control point until the time-limit is satis- 
fied; at that time the job aborts. 

The contents of the location field become a sub-subtitle on the assembler listing. The assembler forces 
upper before and after assembling a PS instruction. 



CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
CYBER 170/Model 175, 176, 740, 750, or 760 Functional Unit: None 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


PS 
PS 


K 


Program stop or exchange jump to (MA) 
Program stop or exchange jump to (MA) 


30 bits 
30 bits 


00000 00000 
OOOOK 



Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


oooooooaoo 


I 




11 


18 ho 






PS 


1 

1 
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8.4.2 ERROR EXIT INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 



ES execution is treated as an error condition and the machine sets the program range condition flag 
in the PSD register. The condition flag then generates an error exit request which causes an exchange 
jump to address (EEA). All instructions issued prior to this instruction are run to completion. Any 
instruction following this instruction in the current instruction word is not executed. W^en all operands 
have arrived at the operating registers as a result of previously issued instructions, an exchange 
jump occurs to the exchange package designated by (EEA). 

The i, j, and k designators, which are ignored by the computation section, are set to zero by the 
assembler. The program address stored in the exchange package on the terminating exchange jump is 
advanced one count from the address of the current instruction word (P=P+1}. This is true regardless 
of which parcel of the current instruction word contains the error exit instruction. 



The error exit instruction is not intended for use in user program code. The program range condition 
flag is set in the PSD register to indicate that the program has jumped to an area of the SCM field which 
may be in range but is not valid program code. This should occur when an incorrectly coded program 
jumps into an unused area of the SCM field or into a data field. The program range condition flag is 
also set on the condition of a jump to address zero. These conditions can be detei-mined on the basis 
of the register contents in the exchange package. The existence of an error exit condition resulting 
from execution of this instruction can thus be deduced. 



The location field of an ES instruction becomes a sub-subtitle on the assembler listing. 
Format: 



Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


ES 




Error exit to EEA 


15 bits 


00000 


ES 


K 


Error exit to EEA 


15 bits 


00000 



Example ; 



Code Generated 



OODOO 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 1 30 








i 

1 
i 



8.4.3 RETURN JUMP INSTRUCTION 

When this instruction is executed, an unconditional jump to the current address plus one [(P)+l ] is 
stored in the upper half of relative address K in SCM and control then transfers to K+l for the next 
instruction. The lower half of the stored word is all zeros. The instruction always branches out of 
the instruction stack and voids all instructions currently in the instruction stack. 

After the instruction is executed the octal word at K is: 



Address K 



4 



P + 1 



0000000000 



59 



29 



00 



Bi=Bj 
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This instruction is intended for transferring control to a subroutine between execution of the current 
instruction word and the follov.'ing instruction word. Instructions appearing after the return jump 
instruction in the current instruction are not executed. The called subroutine must exit at address K 
in CM (SCM). A jump to address K of the branch routine returns the program to the original sequence. 
The assembler sets the unused j designator to zero. 



A force upper occurs after the instruction is assembled. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: None 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


RJ 


K 


Return jump to K 


30 bits 


OlOOK 



Example: 

Code Generated 
aiOO005Z5O + 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 (30 














RJ 


HELP 1 



8.4.4 ECS INSTRUCTIONS (CYBER 170 SERIES, CYBER 70/MODELS 71, 
72, 73, 74 OR 6000 SERIES) 

These instructions initiate either a read or write operation to transfer (Bj)+K 60-bit words between 
extended core storage (ECS) and central memory (CM). The initial ECS address is (XO)+RAj,^g; 
the initial CM address is (A0)+RA^j^j. 

The assembler forces upper before assembling an RE or WE instruction. 

If no error occurs, the next instruct bn executed is the first instruction in the current address plus one 
[(P)+ll. 

Three error conditions cause an error exit to the lower-order 30 bits of the instruction word containing 
the RE or WE instructions. These 30 bits should always hold a jump to an error routine. The conditions 
are: 



1. 



2. 



Parity errors when reading ECS. If a parity error is detected, the entire block of data is 
transferred before the exit is taken. 



The ECS bank from/to which data is to be transferred is not available because the bank is in 
maintenance mode, or the bank has lost power. If either of these conditions exists on an 
attempted read or write, an immediate error exit is taken. 

3. An attempt to reference a nonexistent address. On an attempted write operation, no data 
transfer occurs and an immediate error exit is taken. If the attempted operation is a read, 
and addresses are in range, zeros are transferred to central memory. This is a convenient 
high-speed method of clearing blocks of central memory. 

On a CYBER 170 Model 176, action in the case of error depends on the operating system being run. 
Under SCOPS 2, error processing is just as for the RL and WL instructions (section 8.4. 5). Under 
NOS 1, an error causes the job to abort. Under NOS/BE 1, an error exit to the lower 30 bits of the 
instruction word takes place. This action is provided by the operating system, not by the hardware. 

For additional information about these instructions, refer to the 7030 Extended Core Storage Reference 
Manual. 



8-12 



60492600 G 



Format: 



Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


RE 


Bj 


Read extended core storage 


30 bits 


OlljO 00000 


RE 


K 


Read extended core storage 


30 bits 


Oil OK 


RE 


Bj+K 


Read extended core storage 


30 bits 


OlljK 


WE 


Bj 


Write extended core storage 


30 bits 


012j0 00000 


WE 


K 


Write extended core storage 


30 bits 


0120K 


WE 


Bj±K 


Write extended core storage 


30 bits 


012jK 



Examples : 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




1! 


18 ho 


Oil noo?coo 






p.r 


20OOB 




011700101DO 






PE 


"74-lOOOB 




012F001DOO 






WF 


10QOR+B5 





8.4.5 LCM BLOCK COPY INSTRUCTIONS (CYBER 170/MODEL 176, 
CYBER 70/MODEL 76 OR 7600) 

Block copy instructions move quantities of data between LCM and SCM as quickly as possible. All 
activity in the CPU other than I/O word requests is stopped during a block copy operation. All 
instructions issued prior to a block copy instruction are executed to completion and no further 
instructions issue until the block copy is nearly completed. As a result of these restrictions the 
data flow between LCM and SCM can proceed at the rate of one 60-bit word each clock period. 
When an I/O multiplexer word request for SCM occurs during this transfer, the data flow is 
interrupted for one clock period. The I/O word address is inserted in the stream of addresses to 
the SAS, and the addresses for the block copy are resumed with a minimum of a one clock period delay. 
An additional delay will occur if the I/O reference causes a bank conflict in SCM. 

The length of the block is determined by adding the quantity K to the contents of register Bj. Either 
quantity may be used as an increment or decrement. The result is an 18-bit integer which is truncated 
to a 10-bit quantity. Thus, a maximum block size is 1777g. (For example, if the result of the add is 
003000g, the instruction transfers lOOOg words.) No error indications are given when this occurs unless 
the field length is exceeded causing a block range error. If the block length is zero, the instruction 
becomes a do-nothing instruction; the condition is not error flagged. 

Relative source or destination addresses begin at (AO) in the SCM and at the relative LCM address 
determined from the lowest order 19 bits of (XO). If (XO) is negative, the 19 bits are treated as a 
positive integer. If the sum of (X0-j^g_QQ) and the block count exceeds the (FLL), the copy is not 
executed and the LCM block range condition flag is set in the PSD register. Similarly, if the sum of 
(AO) and the block exceeds (FLS), the copy is not executed and the SCM block range condition flag is 
set in the PSD register. 

COMPASS will truncate a block copy instruction if it begins in the last parcel and its K field is zero. 
Under such conditions, a block copy is a 15-bit instruction. 
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Any error condition occurring during execution of a block copy instruction causes a flag to be set in the 
PSD register but does not interrupt the block copy instruction. No further instructions are issued during 
block transfer of data. Instructions already issued are completed; all other activity, with the exception 
of l/O word requests, stops. 

On a CYBER 170 Model 176, if no error takes place, the next instruction executed is the first instruction 
in the current address plus one [(P) + 1]. Action in the case of error depends on the operating system 
being run. Under SCOPE 2, error processing is just as for any program running on the CYBER 70 
Model 76, as described in the SCOPE 2 Reference Manual listed in the preface. Under NOS 1, an error 
causes the job to abort. Under NOS/BE 1, an error exit to the lower 30 bits of the instruction word takes 
place. This action is provided by the operating system, not by the hardware. 



Format: Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


RL 


Bj 


Block copy (Bj) words from LCM to SCM 


30 bits 


OlljO 00000 


RL 


K 


Block copy (K) words from LCM to SCM 


30 bits 


Oil OK 


RL 


Bj+K 


Block copy (Bj) + K words from LCM to 
SCM 


30 bits 


OlljK 


WL 


K 


Block copy (K) words from SCM to LCM 


30 bits 


01 2 OK 


WL 


Bj 


Block copy (Bj) words from SCM to LCM 


30 bits 


012j0 00000 


WL 


Bj+K 


Block copy (Bj) + K words from SCM to 
LCM 


30 bits 


012jK 



Example : 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




11 


18 |30 










01150010CO 






RL 


10 0B-I-R5 1 


0110002000 






RL 


200nB 1 


012if777f77 






WL 


9tt-lQ08 ! 



8.4.6 EXCHANGE JUMP INSTRUCTION (CYBER 170 SERIES, 

CYBER 70/MODELS 71, 72, 73, 74, AND 6000 SERIES) 

This instruction unconditionally exchange jumps the central processor, regardless of the state of the 
mcHiitor flag bit. Instruction action differs, however, depending on whether the monitor flag bit is set or 
clear. 

This instruction is not legal for a CYBER 170/Model 175, 740, 750, or 760 if the MEJ/CEJ switch is in the 
DISABLE position or if the instruction does not reside in parcel of the instruction word. 

Operation is as follows: 

• Monitor flag bit clear: The starting address for the exchange is taken from the 18-bit Monitor Address 
register. This starting address is an absolute address. During the exchange, the monitor flag bit is set. 

• Monitor flag bit set: The starting address for the exchange is the 18-bit result formed by adding K to 
the contents of register Bj. This starting address is an absolute address. During the exchange, the 
monitor flag bit is cleared. 

For additional information, refer to the appropriate hardware reference manual. 
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The assembler forces upper before and after- assembling an XJ instruction. 

Formats: Functional Unit: Branch 



Operation 


Variable 


Description 


Size 


Octal Code 


XJ 




Exchange jump to MA if in program mode . 


30 bits 


01300 00000 


XJ 


Bj 


Exchange jum^. to (Bj); flag set 


30 bits 


OlSjO 00000 


XJ 


K 


Exchange jump to K; flag set 


30 bits 


0130K 


XJ 


Bj+K 


Exchange jump to (Bj) + K; flag set 


30 bits 


013jK 



Examples: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


OiSOOOOOOn 
0130001000 
0135Q00600 






II 


18 ho 






XJ 
XJ 
XJ 


1 ^ ^ ^ 

( 

lOQOB ' 
1 

85+600B 1 



8.4.7 EXCHANGE EXIT INSTRUCTION (CYBER 70/MODEL 76 OR 7600) 

This instruction is used for calling a system monitor program for input/output, monitor calls, etc. and 
has priority over all other types of exchange jump requests. If an l/O interrupt request or an error exit 
request occurred prior to execution of this instruction, it is denied and the exchange jump specified by 
the RtJ is executed. The rejected interrupt request is not lost, however. The conditions that caused it 
are reinstated when the exchange package enters its next execution interval. 

The normal termination for an exchange package execution interval is through execution of an exchange 
instruction (MJ). The MJ instruction voids the instruction word stack. Any instructions remaining in 
the stack are not executed. The exit mode flag in the PSD register determines the source of the ex- 
change package as follows: 

Exit mode flag set: When the exit mode flag is set, the MJ instruction causes the current program 
sequence to terminate with an exchange jump to a relative address in the SCM field for the current 
program. The exchange package is located at relative address (Bj) ± K. An overflow of the 
lowest order 16 bits of this result causes an error condition that is not sensed in the hardware. 
Should a program erroneously execute an exchange exit instruction with an overflow condition, the 
exchange jump sequence begins at the absolute SCM address corresponding to the lowest order 16 
bits of this sum. This 30-bit form of RU is privileged to a monitor program. 

Exit mode flag not set: When the exit mode flag is not set, the object program terminates the exe- 
cution interval with a 15-bit form of the MJ instruction. The normal exit address (NEA) is the 
absolute address of the exchange package. This is an absolute address in SCM and is generally not 
in the SCM field for the current program. This form of the MJ instruction has a blank variable 
field; the assembler sets the j and k designators to zero. 

The system makes no protective tests on the exchange jump address. 
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All operating register values, program addresses, and mode selections are preserved m the exchang 
package for the object program so that the object program can be continued at a later time. The proj 
address in the object program exchange package is advanced one count from the address of the mstru 
tion word containing the exchange exit instruction. The monitor program normally resumes the obje« 
program at this address. 

The assignment of (NEA) is a responsibility of the system monitor program. If (NEA) has more thaa 
bits of significance, the upper bits are discarded and the lower 16 bits are used as the absolute addr< 
in SCM for the exchange jump. A force upper occurs after the instruction is assembled. 



Formats: 



Functional Unit: None 



Examples r 



Operation 


Variable 


Description 


Size 


Octal Code 


MJ 




Exchange exit to NEA if exit flag clear 


15 bits 


01300 


MJ 




Exchange exit to (Bj) if exit flag set 


30 bits 


OlSjO 0000 


MJ 


Bj+K 


Exchange exit to (Bj) + K if exit flag set 


30 bits 


_J)13jK 


MJ 


K 


Exchange exit to K if exit flag set 


30 bits 


0130K - 



Code Generated 




IOCATK3N 


OPERATION 


VARIABIE 


COMMENTS 




1 




11 




{30 


01300 






MJ 




t 


013«»000^00 






MJ 


8«» + 5Q0n 




013f 777A77 






MJ 


-3Q08+B6 




01300 060 






MJ 


60 OB 


1 ' ' ,t:.'T 



8.4.8 DIRECT LCM TRANSFER INSTRUCTIONS (CYBER 170/MODEL 176, 
CYBER 76/MODEL 76 OR 7600) 

A single word transfer either reads one 60-bit word from LCM and enters this word into an X regist 
or writes one 60-bit word directly into LCM from an X register. \ \ 

The execution time for transferring a word from LCM to an X register depends on whether the 
requested word already resides in one of the bank operand registers.. A read LCM instruction for a 
word not currently residing in a bank operand register will require 17 clock periods for delivering a 
field of eight 60-bit words to the designated X register. A read LCM instruction for a vord already 
residing in a LCM bank operand register as a result of a previous instruction will require three clo( 
periods to deliver the requested word to the designated X register. Thus, although the first 60-bit 
word will require 17 clock periods, the second through eighth words in the same LCM word require 
three clock periods each. This means feat consecutive LCM operands are available, on an average 
every five clock periods as opposed to SCM operands at eight clock periods. j \ > • . 

The LCM address is determined from the low order 19 bits of Xk. Even if (Xk) is negative, the 19 
bits are treated as a positive integer. If the address exceeds the field length (FLL), the word trans 
does not take place and the LCM direct range condition flag is set in the PSD register. Xj is eitna 
the source or destination register. V' y--^ 
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Instructions are buffered to the extent that eadh issues in one minor cycle unless a previous LCM 
reference is in process. When an RX instruction issues, the LCM busy flag is set and remains set 
until the requested word is delivered. 

For a write (WX) instruction, if the word cannot be entered immediately in the proper bank operand 
register, it is held in the LCM write register until the bank operand register is free. 



Formats : 



Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


RXj 


Xk 


Read LCM at (Xk) and set Xj 


15 bits 


014jk 


WXj 


Xk 


Write (Xj) into LCM at (Xk) 


15 bits 


015jk 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




U 


18 130 






RX6 


X5 


1 ^ 

1 






WX7 


xo" 


1 
1 



Examples: 

Code Generated 

01570 



8.4.9 RESET INPUT CHANNEL BUFFER INSTRUCTION (CYBER 170/MODEL 176, 

CYBER 70/MODEL 76 OR 7600) 

This instruction initiates a new record transmission from a PPU to SCM. This instruction prepares 
the input channel (Bk) buffer for a new record transmission from a PPU to SCM. The instruction 
clears the input channel buffer address and resets the input channel assembly counter to the first 
12-bit position in the SCM word. 



This instruction is intended to be privileged to an input routine, that is, one that terminates a record 
of incoming data and prepares for the next record. 

The input routine removes the data in the input channel buffer and then executes this instruction to 
prepare the buffer for the next incoming record. This instruction is effective only if the monitor mode 
flag is set in the program status register. If the monitor mode flag is cleared, this instruction 
becomes a pass instruction. When this instruction issues, it will execute the required channel functions 
without regard to the current status or activity at the input channel buffer. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If 
higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) is zero, this instruction becomes a pass instruction. 



Two or more consecutive RI instructions referring to different channels will issue in consecutive 
clock periods with no interference resulting in the multiplexer. If two consecutive instructions refer to 
the same channel, they repeatedly perform the same function but do not cause interference in the 
multiplexer. 
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Format: 



Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


RI 


Bk 


Reset input channel (Bk) buffer 


15 bits 


0160k 



Example : 

Code Generated 

01607 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 






18 


|30 






RI 


B7 1 ■ ■ 



8.4.10 SET REAL-TIME CLOCK INSTRUCTION (CYBER 170/MODEL 176, 
CYBER 70/ MODEL 76 OR 7600) 

This instruction reads the contents of the CPU clock period counter (real-time clock) and places them ir 
Bj. The 18-bit clock counter advances one count in two's complement mode for each clock period. The 
2 bit is the overflow bit. The CPU is interrupted when the overflow bit is set. When the interrupt 
is handled, the bit is cleared. It permits measurement of CPU execution. 



Format: 



Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


TBj 
TBj 


K 


Set Bj to current clock time 

Set Bj to current clock time; K is ignored. 


15 bits 
15 bits 


016j0 
016j0 



Example: 

Code Generated 

01670 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




n 


18 


iso 






[t87 


^ f~ ^ 

1 



8.4.11 RESET OUTPUT CHANNEL BUFFER INSTRUCTION (CYBER 170/MODEL 176 
CYBER 70/MODEL 76 OR 7600) 

This instruction initiates a new record transmission from SCM to PPU. It clears the output channel 
(Bk) buffer address and disassembly counter, transmits a record pulse over the output channel data 
path to the PPU, and initiates an SCM reference for the first word to be transmitted. 

This instruction is intended for execution in an output routine to initiate a new record transmission 
over an output channel data path. The output channel buffer is normally inactive when this Instruction 
is executed. The output channel buffer is loaded with the data for the next record, and this instruction 
is executed to initiate the transmission. The record pulse is transmitted along with the word pulse as 
soon as the first word of data from the SCM is entered in the ou^ut channel disassembly register. 
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This, instruction is effective only if the monitor mode flag is set in the program status register. If the 
monitor mode flag is cleared, this instruction becomes a pass instruction. Wlien this instruction issues, 
it will execute the required channel functions without regard to the current status or activity at the 
output channel. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If 
higher order bits are set in (Bk), the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) is zero, this instruction becomes a pass instruction. 

Normally, the output channel buffer is inactive when this instruction is executed, the program having 
checked for completion of the previous record before issuing an RO. The program can detect the end 
of record in two ways. First, it can compare the output channel buffer address with a known record 
length. The alternative is to obtain a response from the peripheral unit over the corresponding input 
channel data path. If data is moving over the output channel data path when an RO is issued, the RO 
instruction takes priority, with a resulting loss of data in the previous record. Two or more 
consecutive RO instructions referring to different channels will issue in consecutive clock periods with 
no interference resulting in the multiplexer. If two consecutive instructions refer to the same channel, 
they transmit a record pulse over the output path and restart the buffer repeatedly. A data word may 
or may not be transmitted depending on the timing of the instructions and conflicts that occur. 



Format: 



Functional Unit: None 



(deration 


Variable 


Description 


Size 


Octal Code 


RO 


Bk 


Reset output channel (Bk) buffer 


15 bits 


0170k 



Example : 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




n 


18 |30 


017Q5 






RO 


B5 ! 



8.4.12 READ CHANNEL STATUS INSTRUCTIONS (CYBER 170/MODEL 176 
CYBER 70/MODEL 76 OR 7600) 

These instructions copy the contents of the input or output channel buffer address register indicated 
by masking the low order 4 bits of Bk and enter the value in Bj. The instructions are used for 
monitoring the progress of an input channel buffer or an output channel buffer. 

A channel buffer area is divided into fields by the threshold testing mechanism. The first half of the 
buffer area constitutes one field and the last half of the buffer area the other field. An I/O multiplexer 
interrupt request is generated by the threshold testing mechanism whenever the channel buffer address 
is advanced across a field boundary. This occurs at the center of the buffer area and at the end of the 
buffer area. 

The IBj instruction is the only vehicle for a program to determine whether an I/O multiplexer interrupt 
request was generated by a buffer threshold test or by a record flag. The program must retain the 
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input channel buffer address from one interrupt period to the next. If the buffer address is in the same 
field as for the previous interrupt, the interrupt request was from a record flag. If the buffer address 
is in the opposite field from the previous interrupt, the interrupt request was from a threshold test. 

The lowest order four bits of (Bk) are used in these instructions. The higher order bits are ignored. 
If higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) = 0, the IBj instruction reads the contents of the CPU clock period counter. 
However, the OBj instruction places all zeros into Bj. 

Two or more IBj instructions or OBj instructions may occur in consecutive program instruction locations 
referencing the same or different channels. These instructions may issue in consecutive clock periods 
providing the Bj register reservations do not cause a delay. No interference will result in the multi- 
plexer in these situations. 



If correct results are to be obtained, an IBj instruction must not immediately follow an RI instruction 
nor may an OBj instruction immediately follow an RO instruction. A delay of one clock period is 
sufficient. 



Formats: 



Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


IBj 


Bk 


Bj *-Ilead input channel (Bk) sta;tus 


15 bits 


016jk 


OBj 


Bk 


Bj —Read output channel (Ik) status 


15 bits 


017jk 



Example: 

Code Generated 

01756 





LOCATION 


OPEilATlON 


VAKtABLE 


COMMENTS 


1 




n 


18 


|30 










1 : — :. 

t 
1 






0B5 


«6 


1 

1 



8.4.13 UNCONDITIONAL JUMP INSTRUCTION 

This instruction adds the contents of index register Bi to K and branches to the relative CM (SCM) 
address specified by the sum. The remaining instructions, if any, in the current instruction word are 
not executed. The branch address is K when i is zero. 

Addition is performed in an 18-bit one's complement mode. On a CYBER 170 Series, (except Model 
176), a CYBER 70/ Model 71, 72, 73, or 74 or 6000 Series system this instruction voids the stack. 
On a CYBER 70/Model 76 and 7600 or CYBER 170/Model 176, the instruction word stack is not altered 
by execution of this instruction. The instruction is intended to allow computed branch point destinations 
It is the only CPU instruction in which a computed parameter can specify a program branch destination 
address. All other jump instructions have preassigned destination addresses at execution time. 

The assembler sets the unused j designator to the same value as the i designator. A force upper occurs 
after the instruction is assembled. 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: tJranch 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 7U/Model 76 or 7600 Functional Unit: None 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


JP 


Bi+K 


Jump to (Bi)±K 


30 bits 


02iiK 


JP 


Bi 


Jump to (Bi) 


30 bits 


02ii0 00000 


JP 


K 


Jump to K 


30 bits 


0200K 



Example : 

Code Generate ' 

02?YO00OO0 





LOCATION 


OPERATION 


VARIABIE COMMENTS 


1 




11 


18 ho 






JP 
Jp 


1 , 1 

8S*G0T0 1 
i 

B7 \ 



8.4.14 X-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 

Tiiese instructions cause the program sequence to branch to K or to continue with the current program 
sequence depending on the contents of operand register Xj. The decision is not made until the Xj register 
is free. These instructions do not void the stack. 

The following rules apply to tests made in this instruction group: 

e The ZR and NZ operations test the full 60-bit word in Xj. The words 00 00 and 77 77^ are 

treated as zero. All other words are non-zero. Thus, these instructions are not a valid test for 
floating point zero coefficients. However, they can be used for underflow of floating point quantities. 

« The PL and NG operations examine only the sign bit (bit 59) of Xj. If the sign bit is zero, the word is 
positive; if the sign bit is one, the word is negative. Thus, the sign test is valid for fixed point words 
or for coefficients in floating point words. 

« The IR and OR operations examine the upper-order 12 bits of Xj. 

On the CYBER 170/Model 176, CYBER 70/Model 76 or 7600, the foUowing octal quantities are 
detected as being out of range: 

3777x X (positive overflow) 

40Q0x X (negative overflow) 

1777x ..... X (positive indefinite) 
bOOOx X (negative indefinite) 

All other words are in range. An underflow quantity is considered in range. The value of the 
coefficient is ignored in making this test. 

On a CYBER 70/Model 71, 72, 73, or 74, CYBER 170 Series (except Model 176) or 6000 Series 
computer system, the octal quantities 3777x . . .x and 4000x . . .x are out of range; all other words are 
in range. 
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• The DF and ID operations examine the u[^er-order 12 bits of Xj. Both positive and negative indefinite 
forms are detected: 

1777X X and 6000x x are indefinite. 

All other words are definite. The value of the coefficient is ignored in making this test. 

• An error exit occurs on a 6000 Series, a CYBER 170 Series or a CYBER 70/Model 71, 72, 73 or 74 
system when an indefinite or out of range value is used as an operand of an arithmetic instruction. 
Such error exits can be avoided by using DF, ID, IR, or OR instructions to test for such values before 
using them as operands. 

On a 7600 or CYBER 70/Model 76 system, an error exit occurs as soon as indefinite or out of range 
value is produced as the result of an arithmetic instruction. The DF, ID, IR and OR instructions are 
useful only when a MODE control statement is used to suppress such error exits. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Branch 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: None 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


ZR 


Xj,K 


Branch to K if (Xj) = 


30 bits 


OSOjK 


NZ 


Xj,K 


Branch to K if pcj) 7^ 


30 bits 


031jK 


PL 


Xj,K 


Branch to K if (Xj) sign is plus 


30 bits 


032jK 


NG 


Xj,K 


Branch to K if (Xj) sign is minus 


30 bits 


033jK 


MI 


Xj,K 


Branch to K if (Xj) sign is minus 


30 bits 


033jK 


IR 


Xj,K 


Branch to K if (Xj) in range 


30 bits 


034jK 


OR 


Xj,K 


Branch to K if (Xj) out of range 


30 bits 


035jK 


DF 


Xj,K 


Branch to K if (Xj) definite 


30 bits 


036jK 


ID 


Xj,K 


Branch to K if (Xj) indefinite 


30 bits 


037jK 
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Examples: 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 


J 




n 


18 1 30 


0305002363 + 






ZR 




0313Q0236i* <■ 






NZ 


X3,NQ.MZ£R0 1 


052it002365 + 






PL 


X'^jPLUS ' 


0331002356 + 






NG 


X1,N£G ' 


05310025ob ♦ 






MI 


X1,NEG 1 


U3<t0002367 4- 






Ift 


X0,INRANGt ' 


0351002370 ♦ 






OR 


XltOUTRNGc ' 


0365002371 + 






UF 


XStUEFlNf ' 


J3770Q2372 + 






lu 


X7,lNUfcFNJ I 



8.4.15 B-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 
The following rules apply in the tests made by these instructions: 

• Positive zero is recognized as unequal to negative zero. 

• Positive zero is recogiiized as greater than negative zero. 

• A positive number is recognized as greater than a negative number. 

The 06 and 07 instructions are intended for branching on an index threshold test. The tests are made in a 
19-bit one's complement mode. The (Bi) and the (Bj) are sign extended one bit to prevent erroneous results 
caused by exceeding the modulus of the comparison device. The (Bj) is then subtracted from the (Bi). The 
branch decision is based on the sign bit in the 19-bit result. 

For these instructions, Bi and Bj must be specified in the order indicated below. 
These instructions do not void the instruction stack. 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: branch 
CYBER 170/Mod€l 175, 176, 740, 750, or 760 and the 
CYBER 70/Mo(iel 76 or 7600 Functional Unit: Mone 



Format: 



Oj^e ration 


Variable 


Description 


Size 


Octal Code 


ZR 


K 


Branch to K 


30 bits 


0400K 


ZR 


Bi,K 


Branch to K if (Bi) - 


30 bits 


04i0K 


EQ 


K 


Branch to K 


30 bits 


0400K 


EQ 


Bi,K 


Branch to K if (Bi) - 


30 bits 


04i0K 


EQ 


Bi,Bj,K 


Branch to K if (Bi) = (Bj) 


3a bits 


04ijK 


NE 


Bi,K 


Branch to K if (Bi) ^ 


30 bits 


05i0K 


NE 


Bi,Bj,K 


Branch to K if (Bi) ^ (Bj) 


30 bits 


05ijK 


NZ 


Bi.K 


Branch to K if (Bi) ^ 


30 bits 


05i0K 


PL 


Bi,K 


Branch to K if (Bi) > 


30 bits 


OSiOK 


GE 


Bi,K 


Branch to K if (Bi) > 


30 bits 


OSiOK 


GE 


Bi,Bj,K 


Branch to K if (Bi) > (Bj) 


30 bits 


06ijK 


LE 


Bj,Bi,K 


Branch to K if (Bj) < (Bi) 


30 bits 


06ijK 


LE 


Bj,K 


Branch to K if (Bj) < 


30 bits 


O6O3K 


NG 


Bi,K 


Branch to K if (Bi) < 


30 bits 


07iOK 


MI 


Bi,K 


Branch to K if (Bi) < 


30 bits 


07iOK 


GT 


Bj,Bl,K 


Branch to K if (Bj) > (Bi) 


30 bits 


07ijK 


GT 


Bj,K 


Branch to K if (Bj) >0 


30 bits 


070jK 


1 


Bi,K 


Branch to K if (Bi) < 


30 bits 


07iOK 


LT 


Bi,Bj,K 


Branch to K if (Bi) <(Bj) 


30 bits 


07ijK 
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Examples : 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 






II 


)8 130 


Ot»5000«>?21 <- 






ZR 


85»6ZER0 1 


0405005?2? ^ 






EQ 


90,85, EQUAL | 


0t*530052?7 ♦ 






EQ 


B5,B3,JUMP 1 


0«*0000«?223 ♦ 






EQ 


JUMP 


n51f^00522t* ♦ 






NE 


B1,R5,N0TEQ ' 


05f>0005225 ♦ 






NZ 


bs,bnotzr ' 


0620005226 ♦ 






PL 


B2,BPLUS 1 


06<t«5QQ5227 ♦ 






GE 


B«*,B5,GEQ 


Q65*?005230 ♦ 






GE 


B5,GEB0 ' 


UDrbuu'JcOl * 






LE 


B6,m7,LTHaN 


0770005232 + 






NG 


B7,BNEG { 


0730005233 






MI 


B3,B3LT0 [ 


076700523<* ♦ 






GT 


B7,B6,B7GT j 


0705005235 ♦ 






GT 


B5,B5GTQ ' 


0712005236 + 






LT 


81,B2,BLTB I 



8.4.16 TRANSMIT INSTRUCTION! 

This instruction transfers the 60-bit word in operand register Xj to register Xi. It is essentially a copy 
instruction intended for moving data from X register to X register as quickly as possible. No logical 
function occurs. The assembler sets the i< designator to the value specified for j. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj 


Transmit (Xj) to Xi 


15 bits 


lOijj 



Example: 



Code Generated 



10622 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


ho 






BX6 


X2 ! 
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8.4.17 LOGICAL PRODUCT INSTRUCTION 

This instruction forms the logical product (AND function) of 60-bit words from operand registers Xj and Xk 
and places the product in operand register Xi. Bits of register Xi are set to 1 when the corresponding bits 
of the Xj and Xk registers are 1 as in the following example: 

(Xj) =0101 
(Xk) =1100 

(Xi) = irru0 



This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and k 
designators have the same value, the instruction becomes a transmit instruction. 



CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750 or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj*Xk 


Logical product of (Xj) and (Xk) to XL 


15 bits 


llijk 



Example : 



Code Generated 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 








11 


18 


bo 


11553 






9X5 


X5*X3 [ 



8.4.18 LOGICAL SUM INSTRUCTION 

This instruction fOTms the logical sum (inclusive OR) of 60-bit words from operand registers Xj and Xk and 
places the sum in operand register Xi. A bit of register Xi is set to 1 if the corresponding bit of the Xj or 
Xk register is a 1, as in the following example: 

(Xj) =0101 
(Xk) = 1100 
(Xi) = 1101 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value, the instruction degenerates into a transmit 
instruction. 

CYBER 70/Model 74 or 6800/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj+Xk 


Logical sum of (Xj) and (Xk) to Xi 


15 bits 


12ijk 



Example: 

Code Generated 

12767 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


ho 














BX7 


X6+X7 1 
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8.4.19 LOGICAL DIFFERENCE INSTRUCTION 



This instruction forms the logical difference (exclusive OR) of 60-bit words from operand registers Xj and 
Xk and places the difference in operand register Xi. A bit in register Xi is set to 1 if the corresponding 
bits in the Xj and Xk registers are unlike, as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) =1001 

This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value, the result will be a word of all zeros written 
into register Xi. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj-Xk 


Logical difference of (Xj) and (Xk) to Xi 


15 bits 


ISijk 



Example : 



Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 


|30 






PX6 


XO-Xl I 



8.4.20 COMPLEMENT INSTRUCTION 

This instruction extracts the 60-bit word from operand register Xk, complements it, and transmits this 
complemented quantity to operand register Xi. It is intended for changing the sign of a fixed point or 
floating point quantity as quickly as possible. 

The assembler sets the unused j designator of the instruction to k. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk 


Transmit complement of (Xk) to Xi 


15 bits 


14ikk 



Example : 

Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




1) 


18 ho 






BX3 


, ^ 
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8.4.21 LOGICAL PRODUCT AND COMPLEMENT INSTRUCTION 



This instruction forms the logical product (AND function) of the 60-bit quantity from operand register Xj 
and the complement of the 60-bit quantity from operand register Xk, and places the result in operand 
register Xi. Thus, bits of Xi are set to 1 when the corresponding bits of the Xj register and the 
complement of the Xk register are 1, as in the following example: 

(Xj) =0101 
Complemented (Xk) = 0011 
(Xi) =WST 

This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and k 
designators have the same value, a logical product is formed between two complementary quantities. The 
result will be a word of all zeros. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk*Xj 


Logical product of (Xj) and complement 
of (Xk) to Xi 


15 bits 


15ijk 



Examples: 



Code Generated 



i5k32 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


)8 


i30 














By* 


-X2*X3 1 



8.4.22 COMPLEMENT AND LOGICAL SUM INSTRUCTION 

This instruction forms the logical sum (inclusive OR) of the 60-bit quantity from operand register Xj and 
the complement of the 60-bit word from operand register Xk, and places the result in operand register Xi. 
Thus, bits of Xi are set to 1 if the corresponding bit of the Xj register is one or the corresponding bit of the 
Xk register is a 0, as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = IFTIT 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value, the result is a word of all ones. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk+Xj 


Logical sum of (Xj) and complement of 
(Xk) to Xi 


15 bits 


16ijk 
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Example: 



Code Generated 



1 665'4 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 isO 














BX6 





8.4.23 COMPLEMENT AND LOGICAL DIFFERENCE INSTRUCTION 

This instruction forms the logical difference (exclusive OR) of the quantity from operand register Xj and 
the complement of the 60-bit word from operand register Xk, and places the result in operand register Xi. 
Thus, bits of Xi are set to 1 if the corresponding bits of Xj and register Xk are alike, as in the following 
example: 

(Xj) =0101 
(Xk) = 1100 
(Xi) =0110 

This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value, a logical difference is formed between two 
complementary quantities. The result is a word of all ones. 

CYBER 70/Model 74 or 6800/6700 Functional Unit: Boolean 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Qse ration 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xlv-Xj 


Logical difference of (Xj) and complement 
of (Xlv) to Xi 


15 bits 


17ijk 



Example : 

Code Generated 
17731 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




1) 


18 ho 














BX7 


-Xi-X3 1 



8.4.24 LOGICAL LEFT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi left circular jk places if expression jK is 
positive or left circular 60+jk places if jk is negative. Bits shifted off the left end of operand register Xi 
replace those shifted from the right end. 

The 6-bit shift count jk allows a complete circular shift of (Xi). 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS Places the lower 6 bits of 
the value in the jk fields. If it is negative, COMPASS adds 60 to jk and places the result in the jk fields. 
Thus, a negative value effectively designates a logical right shift. A positive value designates a left shift. 

If the negative shift count is less than -60, the assembler generates a type 7 error. 
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Format: 



CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 1 70/Model 175, 176, 740, 750. or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 



Operation 


Variable 


Description 


Size 


Octal Code 


LXi 


jk 


Logical shift (XI) by + jk places 


15 bits 


201 jk 



Example: 

Code Generated 





tOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




If 


IS 130 






LX3 
LX3 


1 

-1?B 1 



8.4.25 ARITHMETIC RIGHT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi right jk places if expression jk is positive and 
right 60+jk places if expression jk is negative. The rightmost bits of Xi are discarded and the sign bit is 
extended. 



If the shift count is equal to the 60-bit register length, the result contains 60 copies of the sign bit. If the 
operand is positive, a positive zero results. If the operand is negative, a negative zero results. 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS places the lower 6 bits of 
the value in the jk fields. If it is negative, COMPASS adds 60 to jk and places the result in the jk fields. 
Thus, a negative value effectively designates the number of high order bits of the operand that are to be 
retained. If the negative shift count is less than -60, a type 7 error is generated. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176. 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


AXi 


jk 


Arithmetic shift (Xi) by + jk places 


15 bits 


21ijk 



Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




11 


18 {30 


?1537 






fiX5 


37B 


1 

I 
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8.4.26 LOGICAL LEFT SHIFT (Bj) PLACES INSTRUCTION 



This instruction shifts the 60-bit quantity from operand register Xk the number of places specified by the 
quantity in index register Bj and places the result in operand register Xi. The direction of the shift 
operation is determined by the sign of Bj, as follows: 

• If (Bj) is positive (that is, bit 17 of Bj=0), the quantity from Xk is shifted left circular. The low order 6 
bits of (Bj) specify the shift count. The higher order bits are ignored. 

• If (Bj) is negative (that is, bit 17 of Bj=l), the quantity from Xk is shifted right (end off with sign 
extension). For the CYBER 170 Series (except Model 176), the CYBER 70 Series/Models 7i, 72, 73, 
and 74, and the 6000 Series, the one's complement of the lov/ order 11 bits of (Bj) specify the shift 
count. The higher order bits are ignored. If the shift count is 59 to 63 (decimal), the result stored in 
the Xi register consists of 60 copies of the operand sign bit. If the shift count is 64 (decimal) or 
greater, the result register Xi is cleared to 60 zeros. For the CYBER 170/Model 176, CYBER 70/ 
Model 76 and the 7600, the one's complement of the low order 12 bits of (Bj) specify the shift count. 
The higher order bits are ignored. If the shift count is 59 (decimal) or greater, the result stored in the 
Xi register consists of 60 copies of the operand sign bit. 

If -Bj is specified, the assembler converts the instruction to an arithmetic right shift. Tiie (Bj) might be 
the result of an unpack instruction, in which case it is the unbiased exponent and (Xi) is the coefficient. 
This instruction is used for shifting a coefficient from a floating point number to the integer position after 
an unpack operation. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


LXi 


Xk, Bj 


Logically shift (Xk) by (Bj) places to Xi 


15 bits 


22ijk 


LXi 


Bj,Xk 


Logically shift (Xk) by (Bj) places to Xi 


15 bits 


22ijk 


LXi 


Xk 


Transmit (Xk) to Xi 


15 bits 


22i0k 


LXi 


Bj 


Logically shift (Xi) by (Bj) places to Xi 


15 bits 


22iji 


LXi 


-Bj,Xk 


Arithmetic right shift (Xk) by (Bj) 
places to Xi 


15 bits 


23ijk 


LXi 


Xk,~Bj 


Arithmetic right shift (Xk) by (Bj) 
places to Xi 


15 bits 


23ijk 


LXi 


-Bj 


Arithmetic right shift (Xi) by (Bj) 
places to Xi 


15 bits 


23iji 

1 



Example: 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




n 


18 i30 


??675 






LX6 










LX5 


1 


22302 






LX3 


X2 [ 
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8.4.27 ARITHMETIC RIGHT SHIFT (Bj) PLACES INSTRUCTION 



This instruction shifts the 60-bit quantity from operand register Xk the number of places specified by the 
quantity in index register Bj and places the result in operand register Xi. The direction of the shift 
operation is determined by the sign of Bj, as follows: 

o If (Bj) is positive (that is, bit 17 of Bj=0), the quantity from register Xk is shifted right (end off with 
sign extension). For the CYBER 170 Series, (except Model 176) CYBER 70/lVlodel 71, 72, 73. 74 and 
6000 Series Computer Systems, the low order 11 bits of (Bj) specify the shift count. The higher order 
bits are ignored. If the shift count is 59 to 63 (decimal), the Xi register contains 60 copies of the (Xk) 
sign bit. If the shift count is 64 (decimal) or more, the Xi register is zeroed. For the CYBER 170/ 
Model 176, CYBER 70/Model 76 or 7600 Computer Systems, the low order 12 bits of (Bj) specify the 
shift count. The higher order bits are ignored. If the shift count is 59 (decimal) or more, the Xi 
register contains 60 copies of the sign of the operand. 

• If (Bj) is negative (that is, bit 17 of Bj=l), the quantity from register Xk is shifted left circular. The 
complement of the lower order 6 bits of Bj specify the shift count. The higher order bits are ignored. 

If -B is specified, the assembler converts the instruction to a logical left shift. This instruction is intended 
for use in data processing where the amount of shift is derived in the computation. This instruction is also 
useful for adjusting the coefficient of a floating point number while it is in its unpacked form. 

CYBER 70/lViodel 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175. 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


AXi 


Xk.Bj 


Arithmetic shift of (Xk) by (Bj) places to Xi 


15 bits 


23ijk 


AXi 


Bj,Xk 


Arithmetic shift of (Xk) by (Bj) places to Xi 


15 bits 


23ijk 


AXi 


Xk 


Transmit (Xk) to Xi 


15 bits 


23i0k 


AXI 


Bj 


Arithmetic shift of (Xi) by (Bj) places to Xi 


15 bits 


23iji 


AXi 


-Bj,Xk 


Logically shift (Xk) by (Bj) places to Xi 


15 bits 


22ijk 


AXi 


Xk, -Bj 


Logically shift (Xk) by (Bj) places to Xi 


15 bits 


22ijk 


AXi 


-Bj 


Logically shift (Xi) by (Bj) places to Xi 


15 bits 


22iji 



Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 








i) 


18 ho 








AX7 


X^,R6 j 


23211 






AX2 


R1,X1 1 


23502 






ax5 


X2 ' 
1 








AX4 


B2 1 
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8.4.28 NORMALIZE INSTRUCTION 



This instruction normalizes the floating point quantity from operand register Xk and places it in operand 
register Xi. Normalizing consists of shifting the coefficient the minimum number of positions required to 
make bit 47 different from bit 59. This places the most significant bit of the coefficient in the highest 
order position of the coefficient portion of the word. The exponent portion of the word is then decreased 
by the number of bit positions shifted. The number of shifts required to normalize the quantity is entered 
in index register Bj. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


NXi 


Xk 


Normalize (Xk) to Xi 


15 bits 


24iOk 


NXi 


Bj,Xk 


Normalize (Xlc) to Xi; shift count to Bj 


15 bits 


24ijk 


NXi 


Xk,Bj 


Normalize (Xk) to Xi; shift count to Bj 


15 bits 


24ijk 


NXi 




Normalize (Xi) to Xi 


15 bits 


24iOi 


NXi 


Bj 


Normalize (Xi) to Xi; shift count to Bj 


15 bits 


24iji 



Example : 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




11 


18 ho 








MX 5 


X5,e7 j 








NIX5 


1 
1 








NX5, B5 


X2 1 



8.4.29 ROUND AND NORMALIZE INSTRUCTION 

This instruction performs the same operation as the NXi instruction with the exception that the quantity 
from operand register Xk is rounded before it is normalized. Rounding is accomplished by placing a 1 round 
bit immediately to the right of the least significant coefficient bit. The resulting coefficient is increased 
by one-half the value of the least significant bit. Normalizing a zero coefficient places the round bit in bit 
47 and reduces the exponent by 48. Note that the same rules apply for underflow, overflow, infinite, and 
indefinite results. 

If (Xk) is an infinite quantity (3777x . . .xg or 4000x . . .xg) or an indefinite quantity (1777x . . .xg or 
eOOOx . . .Kg), no shift takes place. The contents of Xk are copied into Xi, and Bj is set to zero. 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


ZXi 


Xk 


Round and normalize 


(Xlv) to Xi 


15 bits 


25i0k 


ZXi 


Bj,Xk 


Round and normalize 


(Xk) to Xi; shift 










count to Bj 




15 bits 


25ijk 


ZXi 


Xk, Bj 


Round and normalize 


(Xk) to Xi; shift 










count to Bj 




15 bits 


25ijk 


ZXi 


Bj 


Round and normalize 


(Xi) to Xi; shift 










coimt to Bj 




15 bits 


25iji 


ZXi 




Round and normalize 


(Xi) to Xi 


15 bits 


25i0i 



Example : 



Code Generated 




lOCATION 


OPERATION 


VARIABIE COMMENTS 




1 




n 


18 ho 








2XU 












1 
1 


2536.1 






ZX3,B6 


! 

XI , 



8.4.30 UNPACK INSTRUCTION 



This instruction unpacks the floating point quantity from operand register Xk and sends the 48-bit 
coefficient to operand register Xi and the 11-bit exponent to index register Bj. The exponent packing is 
removed during unpack so that the quantity in Bj is the true one's complement representation of the 
exponent. The contents of Xk need not be normalized. 

The e)q)onent and coefficient are sent to the low-order bits of the respective registers, as shown below: 



Sign 



Packed Exponent 



Coefficient 



Packed Quantity 











59 58 




48 


\ 00 



Xk 



Unpacked 
Exponent 



Exponent Sign 






Extended 






Unpacked Bj '^^^^^^^ 



Coefficient 
Sign Extended 



m 



Xi 



17 10 9 00 59 48 47 

Special operand formats are treated in the same manner as normal operands. 



00 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Boolean 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


UXi 


Xlc 


Unpack (Xlc) to Xi 


15 bits 


26i0k 


UXi 


Bj,Xk 


Unpacic (Xlc) to Xi and Bj 


15 bits 


26ijk 


UXi 


Xl<, Bj 


Unpack (Xk) to Xi and Bj 


15 bits 


26ijk 


UXi 




Unpack (Xi) to Xi 


15 bits 


26i0i 


UXi 


Bj 


Unpaciv (Xi) to Xi and Bj 


15 bits 


26iji 



Example: 



Code Generated 




lOCATtON 


OPERATION 


VARIABLE COMMENTS 


I 




11 


18 |30 










26777 






UX7 


X7,^7 1 


26Sk2 






UX3,X2 




267 3 7 






UX7 


1 
1 


26777 






UX7 


37 i 
1 



8.4.31 PACK INSTRUCTION 

This instruction packs a floating point number in operand register xi. The coefficient of the number is 
obtained from operand register Xk and the exponent is obtained from index register Bj. The exponent is 
packed by reversing the setting of bit 10 of the exponent during the pack operation. The pack instruction 
does not normalize the coefficient. 

Exponent and coefficient are obtained from the proper low-order bits of the respective registers and 
packed in reverse order as shown in the illustration for the unpack instruction. Thus, bits 58 through 48 of 
Xk and bits 17 through 11 of Bj are ignored. There is no test for overflow or underflow. No flags are set in 
the PSD register by this instruction. 

Note that if (Xk) is positive, the packed exponent occupying bits 58 through 48 of Xi is obtained from bits 
10 through 00 of Bj by complementing bit 10; if (Xk) is negative, bit 10 is not complemented but bits 09 
through 00 are complemented. 

The j designator can be set to zero in this instruction to pack a fixed point integer into floating point 
format without using one of the active B registers (exponent=0). 
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CYBER 70/Moclel 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176, 740, 750, or 760 and tne 
CYBER 70/Model 76 or 7600 Functional Unit: Booleaji 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


PXi 


Xl^ 


Pack (Xk) to Xi 


15 bits 


27i0k 


PXi 


X!c, Bj 


Pack (Xk) and (Bj) to Xi 


15 bits 


27ijk 


PXi 


Bj, Xk 


Pack (Xk) and (Bj) to Xi 


15 bits 


27ijk 


PXi 




Pack (Xi) to Xi 


15 bits 


27i0i 


PXi 


Bj 


Pack (Xi) and (Bj) to Xi 


15 bits 


27iji 



Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


ho 


27565 






PX5 


X5,B6 


1 


27671 






PX6,B7 


XI 


! 
j 


27505 






PX5 




i 


2 75 65 




|PX5 


B6 


1 



8.4.32 UNROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the unrounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the result in operand register Xi. The packed result is the upper half of a 
double precision sum or difference. 

At the start both arguments are unpacked, and the coefficient of the argument with the smaller exponent 
is entered into the upper half of the accumulator. The coefficient is shifted right by the difference of the 
exponents. The other coefficient is then added to or subtracted from the upper half of the accumulator. If 
overflow occurs, the result is right-shifted one place and the exponent of the result increased by one. The 
upper half of the accumulator holds the coefficient of the result, which is not necessarily in normalized 
form. The exponent and upper coefficient are then repacked in operand register Xi. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Add 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Add 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


FXi 


Xj+Xk 


Floating point sum of (Xj) and (Xk) to Xi 


15 bits 


30ijk 


FXi 


Xj-Xk 


Floating point difference of (Xj) minus 
(Xk) to Xi 


15 bits 


Slijk 
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Examples: 



Code Generated 




tOCATION 


OPERATION 


VARIABLE COMMENTS 


31?13 


I 




11 


18 ho 






FX2 


Xf* + X5 ' 

1 

xi-y3 [ 



8.4.33 DP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the sum or difference of two floating point numbers as in the single precision 
instructions, but pack tiie lower half of the double precision result with an exponent 48 less than the upper 
sum. The result is not necessarily normalized. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Add 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/lVIodel 76 or 7600 Functional Unit: Floating Add 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


DXi 


Xj+Xlv 


Floating DP sum of (Xj) and (Xk) to Xi 


15 bits 


32ijk 


DXi 


Xj-Xlv 


Floating DP difference of (Xj) and (Xk) 
to Xi 


15 bits 


33ijk 



Examples: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


32323 


I 




11 


18 bo 






OXt+ 


K2+X3 j 



8.4.34 ROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the rounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the upper portion of the double precision result in operand register Xi. These 
instructions are intended for use in floating point calculations involving single precision accuracy. 
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Format: 



CYBER 70/Model 74 or G600/670Q Functional Unit: Floating Add 
CYBER 170/Mod8l 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Ada 



Operation 


Variable 


Description 


Size 


Octal Code 


RXi 


Xj+Xk 


Rounded floating sum of (Xj) and pck) 
to Xi 


15 bits 


34ijk 


RXi 


Xj-Xk 


Rounded floating difference of (Xj) minus 
pOc) to Xi 


15 bits 


35ijk 



Examples: 



Code Generated 
35653 





lOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




11 








PX5 
RX6 


X3+XU 1 
X5-Y3 j 



8.4.35 LONG ADD {FIXED POINT) INSTRUCTIONS 

These instructions form the 60-bit one's complement integer sum or integer difference of quantities from 
operand registers Xj and Xk and store the result in operand register Xi. An overflow conditio is ignored. 

The instructions are intended for addition or subtraction of integers too large for handling in the increment 
unit. They are also useful for merging and comparing data fields during data processing. 

For an addition, if both operands are zero, the result is zero. If either zero operand is positive zero (all 
O's), the result is a positive zero quantity. If both operands are minus zero (aU I's), the result is a negative 
zero quantity. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Long Add 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Long Add 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


IXi 


Xj+Xk 


Integer sum of (Xj) and (Xk) to Xi 


15 bits 


36ijk 


IXi 


Xj-Xk 


Integer difference of (Xj) minus (Xk) 
to Xi 


15 bits 


37ijk 



Example: 



Code Generated 

365 1»5 
37631 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 isO 






TX5 
1X6 


1 

X .+ y 5 1 
1 

X3-V1 1 
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8.4.36 UNROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 



This instruction multiplies two floating point quantities obtained from operand registers Xj (multiplier) and 
Xk (multiplicand) and packs the upper product result in operand register Xi. 

In this operation, the exponents of the two operands are unpacked from the floating point format and are 
added with a correction factor of 48 to form the exponent for the result. The coefficients are multiplied 
as signed integers to form a 96~bit integer product. The upper half of this product is then extracted to 
form the coefficient of the result. The result is a normalized quantity only when both operands are 
normalized; the exponent in this case is the sum of the exponents plus 47 (or 48). The result is not 
normalized when either or both operands are not normalized. 

CYBER 70/Modei 74 or 6600/6700 Functional Unit: Floating Multiply 
CYBER 170/Model 175, 176, 740, 750, or 760 and tiie 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Multiply 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


FXi 


Xj*Xk 


Floating point product of (Xj) and 
(Xk) to Xi 


15 bits 


40ijk 



Example : 



Code Generated 

n 11 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




11 


18 ho 














FXO 


Xl^Vl [ 
1 



8.4.37 ROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies the floating point number from operand register Xk (multiplicand), by the 
floating point number from operand register Xj. The upper product result is packed in operand 
register Xi. (No lower product is available.) The multiply operation is identical to that of the single 
precision instruction except that a rounding bit is added in bit position 46 of the 96-bit product. The upper 
half of the product is then extracted to form the coefficient for the result. An alternate output path is 
provided with a left shift of one bit position to normalize the result coefficient if the original operands 
were normalized and the double precision product has only 95 bits of significance. The exponent for the 
result is decremented by one count in this case. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Multiply 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Multiply 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


RXi 


Xj*Xk 


Rounded floating point product of (Xj) 
and (Xk) to Xi 


15 bits 


41ijk 
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Example: 



Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 ho 














RX2 


1_ . . 

1 



8.4.38 DP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj and Xk and 
packs the lower product in operand register Xi. The two 48-bit coefficients are multiplied together to 
form a 96-bit product. The lower order 48 bits of the product (bits 47 through 0) are then packed together 
with the resulting exponent. The result is not necessarily normalized. The exponent of this result is 48 less 
than the exponent resulting from an unrounded single precision instruction using tlie same operands. 

This instruction is intended for use in multiple precision floating point calculations. It may also be used to 
form the product of two integers providing the resulting product does not exceed 48 bits of significance. 
The operands must be packed in floating point format before executing this instruction. The results must 
be unpacked to obtain the integer product. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Multiply 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Multiply 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


DXl 


Xj*Xk 


Floating point DP product of (Xj ) and 
(Xk) to Xi 


15 bits 


42ijk 



Example: 



Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 ho 














DX3 


1 

1 



8.4.39 INTEGER MULTIPLY INSTRUCTION 

The CPU integer multiply instruction is, to COMPASS, synonymous with the double precision floating point 
multiply instruction. Regardless of how it is written in COMPASS, the 42ijk instruction is executed as 
follows: If each operand register has aU zeros or all ones in its leftmost 12 bits, the 47-bit integer product 
is formed in Xi with sign extension in its leftmost 12 bits. (Exception: if each operand has bit 47 different 
from its sign bit, the result is shifted left one bit position.) Otherwise, a double precision floating point 
multiplication is performed. Thus, there is no need to pack exponents into the operands, and unpack the 
result, for an integer multiply. COMPASS provides the alternate symbolic representations IXi Xj*Xk and 
DXi Xj*Xk for the 42ijk instruction as an aid to program readability, so the programmer can indicate 
whether or not the instruction is being used for integer multiplication. 
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CYBER 70/Model 74 op 6600/6700 Functional Unit: Floating Multiply 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 7i)/Model 76 or 7600 Functional Unit: Floating Multiply 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


EXI 


Xj*Xl< 


Integer product of (Xj) and (Xl^) to Xi 


15 bits 


42ijk 



Example: 



Code Generated 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




11 


18 ho 








1X2 


i 

X3*X«* j 
1 



8.4.40 MASK INSTRUCTION 

This instruction clears register Xi and forms a mask in it. A positive value for expression jk defines the 
number of ones in the mask as counted from the highest order bit in Xi. A negative value for expression jk 
defines the number of bits (unmasked) counted from the low order bit in Xi. The completed masking 
word consists of ones in the high order bit positions of the word and zeros in the remainder of the word. 

The contents of operand register i are zero when jk is zero. The contents of operand register i are all ones 
when jk is 60. 

This instruction is intended for generating masks for logical operations. Used with the shift instruction, 
this instruction creates an arbitrary field mask faster than by reading a previously generated mask from 
storage. 

In COMPASS notation, if the value of absolute expression jk is positive, the assembler inserts it into the jk 
field of the assembled instruction. If the value of absolute expression jk is negative, the assembler adds 60 
to the expression value and places the sum in the jk field of the assembled instruction. 

A negative jk value less than -60 results in a type 7 assembly error. 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: Shift 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Shift 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


MXi 


jk 


Form mask in Xi, + jk bits 


15 bits 


43ijk 



Example: 

Code Generated 

^♦3360 





lOCATlON 


OPERATION 


VARIABLE COMMENTS 


1 




n 


18 ho 






MXO 


i 

1 






MX3 


-14b 1 



8.4.41 UNROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

This instruction divides two normalized floating point quantities obtained from operand registers Xj 
(dividend) and Xk (divisor) and packs the quotient in operand register Xi. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Divide 
CYBER 170/Modei 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Divide 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


FXi 


Xj/Xk 


Floating point divide of (Xj) by (Xk) 
to Xi 


15 bits 


44ijk 



Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






I 




n 


18 ho 


Uif631 






FX6 


X3/X1 


1 

1 





8.4.42 ROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

This instruction divides the floating quantity from operand register Xj (dividend) by the floating point 
quantity from operand register Xk (divisor) and packs the rounded quotient in operand register Xi. 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Divide 
CYBER 170/Model 175, 176, 740, 750, op 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Floating Divide 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


RXi 


Xj/Xi^ 


Rounded floating point division of (Xj) 
by (Xk) to Xi 


15 bits 


45ijk 



Example : 



Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




n 


18 ho 






RV7 





8.4.43 PASS INSTRUCTION 

The no-operation (pass) instruction is not associated with a functional unit. This instruction is a do-nothing 
instruction used typically to pad the program between steps. An integer value in the variable field 
(optional) is inserted into the lower 8 bits of the instruction. The assembler automatically pads the 
remainder of a word whenever a force upper occurs; in this case, the programmer is not required to insert 
the NO. 

On a machine with a Compare/Move Unit (CMU), a value of n greater than or equal to 4OO3 causes the 
instruction to be interpreted as a CMU instruction. 

On a CYBER 170/Model 175, 740, 750, or 760, a value of n greater than or equal to 4008 is illegal. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: iNone 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: None 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


NO 




Pass 


15 bits 


46000 


NO 


n 


Pass 


15 bits 


46n 



Example : 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




M 


18 IsO 








NO 


^ j _ 

1 
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8.4.44 POPULATION COUNT INSTRUCTION 



This instruction counts the number of 1 bits in operand register Xk and stores the count in the lower order 
6 bits of operand register Xi. Bits 59 through 06 are cleared. 

If Xk is a word of all ones, a count of 60 (decimal) is delivered to the Xi register. If Xk is a word of all 
zeros, a zero word is delivered to the Xi register. 

The assembler sets the unused j designator to k. 

CYBER 70/Model 74 or 6600/6700 Functional Unit: Floating Divide 
CYBER 1 70/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/Model 76 or 7600 Functional Unit: Population Count 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


CXi 


Xk 


Count of number of I's in (Xk) to Xi 


15 bits 


47ikk 



Example: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




n 


18 |30 


1^7700 






0X7 


XQ 1 



8.4.45 SET A REGISTER INSTRUCTIONS 

These instructions are intended for fetching operands from storage for computation and for delivering 
results back into storage. The instructions have two destination registers: the Ai register, which receives 
the address formed from the operands, and either the Xi register or a CM (SCM) storage location. 

Operands are obtained from address (A), index (B), and operand (X) registers as weU as from the 
instruction itself (K = 18-bit operand). Operands obtained from an Xj operand register are the truncated 
lower 18 bits of the 60-bit word. The highest order bits are ignored; an overflow condition is also ignored. 

If the i designator is nonzero, a storage reference is made using the lower 15, 16, or 17 bits of the resulting 
sum or difference as the relative storage address depending on machine size. The upper bits are ignored. 
The type of storage reference is a function of the i designator value, as follows: 

i = 0; no storage reference 

i = 1, 2, 3, 4, or 5; contents of CM (SCM) relative address (Ai) to register Xi 
i = 6 or 7; contents of register Xi stored at CM (SCM) relative address (Ai) 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: Increment 
CYBER 170/Model 175, 176, 740, 750, or 760 and the 
CYBER 70/lVIodel 76 or 7600 Functional Unit: Increment 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


SAi 


Aj+K 


Set Ai to (Aj)_f K 


30 bits 


50ijK 


SAi 


K 


Set Ai to K 


30 bits 


51i0K 


SAi 


Bj+K 


Set Ai to (Bj) + K 


30 bits . 


51ijK 


SAi 


Xj+K 


Set Ai to (Xj) + K 


30 bits 


52ijK 


SAi 




Set Ai to (Xj) 


15 bits 


53ij0 


SAi 


; Xj+Bk 


Set Ai to (Xj) + (Bk) 


15 bits 


53ijk 


SAi 


Bk+Xj 


Set Ai to (Xj) + (Bk) 


15 bits 


53ijk 


SAi 


Aj 


Set Ai to (Aj) 


15 bits 


54ij0 


SAi 


Aj+Bk 


Set Ai to (Aj)+ (Bk) 


15 bits 


54ijk 


SAi 


Bk+Aj 


Set Ai to (Aj) + (Bk) 


15 bits 


54ijk 


SAi 


Aj-Bk 


Set Ai to (Aj) - (Bk) 


15 bits 


55ijk 


SAi 


-Bk+Aj 


Set Ai to (Aj) - (Bk) 


15 bits 


55ijk 


SAi 


Bj 


Set Ai to (Bj) 


15 bits 


56ij0 


SAi 


Bj+Bk 


Set Ai to (Bj) + (Bk) 


15 bits 


56ijk 


SAi 


-Bk 


Set Ai to (BO) - (Bk) 


15 bits 


57i0k 


SAi 


Bj-Bk 


Set Ai to (Bj) - (Bk) 


15 bits 


57ijk 


SAi 


-Bk+Bj 


Set Ai to (Bj) - (Bk) 


15 bits 


57ijk 
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Examples : 







LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




11 


18 |30 


5 n 1 1 a c ^ n 1 








Ay + 1 




r, f) n 7 7 7 7 7 'i 












^ I ? 1 n n n n 












5^31 -777771 








X 1-6 


i 










Xl + Bl 
















i4 6 «4 t 




















^^ 
























B1 + P1 




^77?\ 








32-Pl 





8.4.46 SET B REGISTER INSTRUCTIONS 

These instructions perform one's complement addition and subtraction of 18-bit operands and store an 
18-bit result in index register Bi. Note the result will never be -0 unless -0 is added to -0. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as from the 
instruction itself (K = 18-bit operand). Operands obtained from an Xj operand register are the truncated 
lower 18 bits of the 60-bit word. The highest order bits are ignored; an overflow condition is also ignored. 

If the i designator is a zero, the instruction is a do-nothing instruction. 



8-46 



60492600 G 



CYBER 70/Model 74 or 6600/6700 Functional Unit: Increment 

CYBER 170/Model 175, 176. 740. 750, or- 760 and the 1 
CYBER 70/Model 76 or 7600 Functional Unit: Increment f 

Format: 



1" 

Operation 


Variable 


Description 


Size 


Octal Code 


SBl 


Aj+K 


Set Bi to (Aj) + K 


30 bits 


60ijK 


iSBi 


K 


Set Bi to K 




BliOK 


|SBi 


Bi+K 


Set Bi to (Bj) + K 


"^0 bits 


fil ilK 

UilJXV 


SBi 


Xj+K 


Set Bi to (Xj) + K 


30 bits 


62ijK 


SBi 


Xi 


Set Bi to (Xj) 


1 S hif-«? 

X tJ kJL to 


O OA J V/ 


iSBi 


Xj+Bk 


Set Bi to (Xj) + (Bk) 


1 fi bits 


63ijk 


SBi 


Bk+Xj 


Set Bi to (Xj) + (Bk) 


1 5 bi ts 


63ijk 


SBi 

t 


Aj 


Set Bi to (Aj) 


15 bits 


64ii0 


;SBi 


Aj+Bk 


Set Bi to (Aj) + (Bk) 


15 bits 


64ijk 


teBi 


Bk+Aj 


Set Bi to (Aj) + (Bk) 


15 bits 


64ijk 


SBi 


Aj-Bk . 


Set Bi to (Aj) - (Bk) 


15 bits 


65ijk 


SBi 


-Bk+Aj 


Set Bi to (Aj) - (Bk) 


15 bits 


65ijk 


SBi 


Bj 


Set Bi to (Bj) 


15 bits 


66ij0 


SBi 


Bj+Bk 


Set Bi to (Bj) + (Bk) 


15 bits 


66ijk 


SBi 


-Bk 


Set Bi to (BO) - (Bk) 


15 bits 


67i0k 


SBi 


Bj-Bk 


Set Bi to (Bj) - (Bk) 


15 bits 


67ijk 


SBi 


-Bk+Bj 


Set Bi to (Bj) - (Bk) 


15 bits 


67ijk 



60492600 G 



8-47 



Examples: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




II 


!8 ho 










i 

n-5 j 


611077777? 








1 

1 








SO 2 


1 


*^ 2 .? 1 n 1 n 








1 

y 1 + 1 n n , 










X?4-R7 1 








cn5 


AU+Bl j 








S?5 


^k 1 








•^06 












ftU-P3 j 


P)6711 






'sR7 


Bl+Pl 1 


877^.1 






^B7 





8.4.47 SET X REGISTER INSTRUCTIONS 

The SXi instructions perform one's complement addition and subtraction of 18-bit operands and store an 
18-bit result into the lower 18 bits of operand register Xi. The sign of the result is extended to the upper 
42 bits of operand register Xi. An overflow condition is ignored. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as the instruction 
itself (K = 18-bit operand). Operands obtained from an Xj register are the truncated lower 18 bits of the 
60-bit word. The highest order bits are ignored. 
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CYBER 70/Model 74 or 6600/6700 Functional Unit: Increment 

CYBER 170/tModel 175, 176, 740, 750, or 760 and the I 
CYBER 70/Model 76 or 7600 Functional Unit: Increment 1 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


D^l 




bee Al to (/ij) + iN- 


OA 1^ i 4- « 

3v bits 


- - 

70ijK 




IS. 


bet Ai to IV 


30 bits 


71iOK 


QVi 

oAl 


±}J + K 


bet Ai to (±33 ; + 


30 bits 


71ijK 




AJ + lV 


bet AI to (AJ; + iv 


30 bits 


72ijK 


CVi 

oAl 




bet AI to (Aj) 


15 bits 


73ij0 


bAl 


AJ+13K 


bet Xi to (Xj) + (Bk) 


15 bits 


73ijk 


oAl 




Set Xi to (Xj) + (Bk) 


15 bits 


73ijk 


oXl 


Aj 


« i. Vi i. ^ / A * V 

Set Xi to (Aj) 


15 bits 


74ij0 






oe L Al 10 [r\j ) + (JljK ; 


lu bits 


74ijk 


SXi 


Bk+Aj 


Set Xi to (Aj) + (Bk) 


15 bits 


74ijk 


SXi 


Aj-Bk 


Set Xi to (Aj) - (Bk) 


15 bits 


75i3k 


SXi 


-Bk+Aj 


Set Xi to (Aj) - (Bk) 


15 bits 


75ijk 


SXi 


Bj 


Set Xi to (Bj) 


15 bits 


76ij0 


SXi 


Bj+Bk 


Set Xi to (Bj) + (Bk) 


15 bits 


76ijk 


SXi 


-Bk 


Set Xi to (BO) - (Bk) 


15 bits 


77i0k 


SXi 


Bj-Bk 


Set Xi to (Bj) - (Bk) 


15 bits 


77ijk 


SXi 


-Bk+Bj 


Set Xi to (Bj) - (Bk) 


15 bits 


77ijk 
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Examples: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 




I 




11 


18 |30 



















cy 1 


o n o o r% 

— >* / / n . 


f i 1 M ij 'J 1 '. n n 






c y c> 


o 1 4. c; 1 


i' r ' ■ / / » H «» 








Y — ^ 7 Q 


7?Ut*? 








X£»*-32 ' 








^X5 










SX5 


flit 1 








^X6 










SXF, 




7F7 7e> 






<:X7 


B7 + 9fS j 


7 7 7 1 






*^y ? 





8.5 CMU SYMBOLIC MACHINE INSTRUCTIONS 

The Compare/Move Unit (CMU) is a standard CPU hardware component of the CYBER 70 Series Model 72 
I and Model 73, and the CYBER 170/Models 172, 173, 174, 720, and 730. It provides CPU instructions for 
moving and comparing data fields that consist of strings of 6-bit characters. Data fields can span word 
boundaries and can begin and end at any character position within a word. A data field is specified by its 
length in characters and the location of its leftmost character (according to word address and character 
position). Data fields cannot be in the operating registers nor in ECS. 

Each 60-bit word of a data field contains 10 character positions numbered to 9 from left to right (high 
order to low order). 

COMPASS provides a symbolic forms of the four CMU instructions plus a pseudo instruction used to 
generate a descriptor word to be referenced by the indirect move instruction. Of tlie four instructions, the 
indirect move (IM) instruction is the only one that syntactically resembles other CPU instructions. The 
other three instructions have formats dissimilar to CPU instructions and are generated through COMPASS 
pseudo instructions. AU of these instructions must begin at the top of a 60-bit word; COMPASS automat- 
ically forces upper before each of them unless the location field contains a minus sign. All but IM are 60 
bits in length. IM is 30 bits, but the hardware requires that the instruction be in the upper half of its word. 
The lower half of the word is not executed. COMPASS automatically forces upper following IM, unless the 
next instruction has a minus sign in its location field. 
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8.5.1 IM - INDIRECT MOVE 



The indirect move instruction moves the contents of a data field to another location. It is a 30-bit 
instruction that specifies the address of a descriptor word which, in turn, contains the length and address of 
the data fields. 

The assembler forces upper before and after the IM instruction. 

Tile descriptor word is fetched from storage location (Bj)+K. If the data field lengtn is zero, the 
instruction is executed as a pass but the execution time is longer. Otherwise, the contents of the source 
field are moved to the destination field. If the two fields overlap, the results are undefined. The XO 
register is used for intermediate storage during execution of the instruction, and is cleared upon 
completion of the instruction. 



Operation 


Variable 


Description 


Octal Code 


IM 


K 


Move data according to word at K 


4640K 


IM 


Bj±K 


Move data according to word at(Bj)+ K 


464jK 


IM 


Bj 


Move data according to word at (Bj) 


464j 000000 



8.5.2 MD - INDIRECT MOVE DESCRIPTOR WORD 

The iVID pseudo instruction generates a descriptor word for use by the indirect move (IM) instruction. 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


sym 


MD 


j£,k ,c ,k,,c, 
s s d d 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the descriptor word. 

£ Absolute address expression specifying the field length in characters (0 through 8191). The 

upper 9 bits (£) are placed in bits 56 through 48 of the descriptor word; the lower 4 bits {$.) are 
placed in bits 29 through 26. 

kg An expression specifying the first word address of the source field in CM. 

Cg An absolute expression (0 through 9) specifying the starting character position of the source 
field within the word at location kg. Characters are numbered from left to right. 

k(j An expression specifying the first word address of the destination field in CM. 

An absolute expression (0 tiirough 9) specifying the starting character position of the 
destination field within the word at location k^j. 
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iidirect Move Descriptor Word format: 



59 


48 


30 


26 22 


U 


5 00 





^12-4 


source 
address 


{src 
^3-Och 
1 


des 
ch 


destination 
address 



Example: 



Code Generated 







lOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




11 


18 ho 


) u 7 6 U 5 'J u L 4 5 u 7 u j 




nwoRO 


• 


I 

1 


f640Ul0665 






• 
• 

n 


1 

owo?n ' 
I 



3UFFA is at address 2560; BUFFB is at address 3584. 
3.5.3 DM - DIRECT MOVE 

The direct move (DM) pseudo instruction generates a CMU instruction that moves the contents of a data 
leld to another data field. The machine instruction occupies one full word. The instruction includes its 
)wn data field descriptor. 

The assembler forces upper before a DM instruction. 

:f the data field length is zero, the instruction is executed as a pass, but the execution time is longer, 
otherwise, the contents of the source field are moved to the destination field. If the two fields overlap, 
;he results are undefined. The XO register is used for intermediate storage during execution of the 
nstruction and is cleared upon completion of the instruction. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DM 


s s d d 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the instruction word. 

a Absolute address expression specifying the field length in characters (0 through 127). 

kg An expression specifying the first word address of the source field in CM. 

Cg An absolute expression (0 through 9) specifying the starting character position of the source 
field within the word at location kg. 

k<j An expression specifying the first word address of the destination field in CM. 

Cfj An absolute expression (0 through 9) specifying the starting character position of the 

destination field within the word at location k^j. Characters are numbered from left to right. 
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Octal format of instruction: 
59 51 48 



Example: 



30 26 22 18 



00 



465 


n j source 


f Jsrc 
\ 


des 


destination 


6-4 address 
1 


ch 


address 



Code Generated 





LOCATION 


OPERATION 


VARIABIE 


COMMENTS 


1 




II 


18 ho 






DM 


127, ?UFFA, I 


1 



8.5.4 CC - COMPARE COLLATED 

The compare collated (CC) pseudo instruction generates a CMU instruction that compares the contents of 
two data fields, one character at a time, from left to right, until a pair of corresponding characters is 
found to have unequal collating values or until the data fields are exhausted. It is a 50-bit instruction that 
occupies one full word. It cannot be split between two words. The instruction includes its own data field 
descriptor. Register AO contains the first word address of a table in storage that contains the collating 
values to be used in comparing characters. The result of the comparison is placed in register XO. 

The first word address of the collating table is obtained from register AD. The contents of the data fields 
are compared from left to right, one character at a time from each field, until two unequal characters are 
found. The collating value of each character is obtained from the collating table. If these values are 
equal, the compare continues until another character pair is unequal or until all characters have been 
compared. If the collating values are unequal, the two data fields are unequal and the field with a larger 
collating value is the greater of the two fields. The collating values are treated as 6-bit unsigned integers. 
Note that two unequal characters could have the same collating value and would compare equal. 

Upon instruction completion, register XO contains a 60-bit signed integer as follows: 

(Field A)>(Field B) (XO)=£-n; (X0)>0 

(Field A)=(Field B) (X0)=0 

(Field A)< (Field B) (XO)=n-£; (X0)<0 

n is the number of pairs of characters that compared equal. If £=0, then (XO) is 0. 
The format of the collating table for 6-bit characters is: 



59 



53 



47 



41 



35 



29 



23 



27 



11 



(AO) 


GO 


01 


02 


03 


04 


05 


06 




(A0)+1 


10 


11 


12 


13 


14 


15 


16 




(A0)+7 


70 


i 

71 


72 


73 


i 

74 


i 

75 


i 

76 
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Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


sym 


cc 





sym 
i 

ko 



If present, sym is assigned ttie value of the location counter after the force upper occurs. It 
Decomes the symbolic address of the instruction. 

x\bsolute address expression specifying the field length in characters (0 through 127). 

An expression specifying the first word address of the first data field in CM. 

An absolute expression specifying the starting character position of the first data field witnin 
the word at location k^. Characters are numbered from left to right. 

An expression specifying the first word address of the second data field in CM. 

An absolute expression (0 through 9) specifying the starting character position oi the second 
data field within the word at location k^. 



Octal format of instruction: 



59 51 


48 


30 


26 22 


18 00 


466 


^6-1 
1 


first string 
address 


n 1 

^3-0 ch 
1 


ss 
ch 


second string 
address 



Example: 



Code Generated 



51uaO J312G 

ttoSZOaSjUC 74J5U JTujO 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




1) 


18 UO 








TABLE ' 






CG 


i 



8.5.5 CU - COMPARE UNCOLLATED 

The compare uncoUated (CU) pseudo instruction generates a CMU instruction that compares the contents 
of two data fields, one character at a time, from left to right, until a pair of corresponding characters are 
found to have unequal values or until the data fields are exhausted. The machine instruction is a 60-bit 
instruction that occupies one full word and cannot be split between two words. It includes its own aata 
field descriptor. The result of the comparison is placed in register XO. 

Execution resembles the CC instruction except that AO and the collating table are not used. Instead, tne 
characters are compared directly with each character regarded as a 6-bit unsigned binary integer. 
Register XO is set in the same manner as by the CC instruction. 
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Format: 



LOCATION 


OPERATION 


VARIABLE SUBflELDS 


sym 


CU 





sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the instruction. 

i Absolute address expression (0 through 127) specifying the field length in characters. 

kg An expression specifying the first word address of the first data field in CM. 

Ca An absolute expression (0 through 9) specifying the starting character position of the first data 
field within the word at location k^. Characters are numbered from left to right. 

kb An expression specifying the first word address of the second data field in CM. 

C5 An absolute expression (0 through 9) specifying the starting character position of the second 
data field within the word at location kj^. 



Octal format of instruction: 
59 51 48 



30 26 22 18 



00 



467 


£ 1 first string 
address 


c 1 fs 
^3-0 ch 


ss 


second string 


ch 


address 



Example : 



Code Generated 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 














CU 


ia7,3UFFA,0,j=»UFF3,5 

! 
1 
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FPU SYMBOLIC MACHil^E ii^STRUCTiOI^S 




The COMPASS assembler recognizes symbolic notation for peripheral processor unit (PPU) 
instructions. When a PPU or PERIPH pseudo instruction is in the first statement group, the assembler 
identifies each symbolic instruction by name and generates a one word (12 bit) or two word (24 bit) 
object code machine instruction under control of the current origin, location, and position counters. 
All PPU code is absolute. Numeric data must be in integer notation. Floating point notation is illegal, 

9.1 MACHINE INSTRUCTiON FORMATS 

An assembled instruction has a 12-bit or 24-bit format. The 12-bit format has a 6-bit operation code f 
and a 6-bit operand d. A PPU accomplishes program indexing and manipulates operands in several 
modes. The 12-bit and 24-bit instruction formats provide for 6-bit, 12-bit, or 18-bit operands and 
6-bit or 12-bit addresses. Figures 9-1 and 9-2 illustrate the 12-bit instruction format and the 24-bit 
instruction format, respectively. 



Direct Mode: 



d = memory address of operand 



operation 
code 



Indirect Mode: 



(P) 



f 



d 



d = memory address of the address 
of the operand 



11 



06 05 



00 



No Address Mode: 



d 



6-bit operand, shift count, or 
relative address 



Other: 



d 



special value; e. g. , channel designator 



Figure 9-1. PPU 12-bit Instruction Format 
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The 24-bit format uses the 12-bit quantity m, which is the contents of the next program address (P + 1), 
with d or the contents of d to form an 18-bit operand or a 12-bit operand address. 



hidexed Mode: 

d = address of the index for 
modifying the address of 
the operand 



m = base address of the operand 
00 (d) + m = address of operand 



Constant Mode: 

00 

dm = 18-bit operand 
Other: 

dm = special values; e. g. , d = channel 
designator and m = 12-bit address 
of word count on lAM and OAM 
instructions 

Figure 9-2. PPU 24-bit Instruction Format 



operation 
code 



(P) 



11 



06 05 



(P+1) 
11 



m 



f.2 SYMBOLIC I^OTATION 

This section describes notation used for coding symbolic PPU machine instructions. Instructions are 
described in octal operation code sequence which generally reflects the mode of addressing. 
Instructions unique to a computer system are identified as such. 

The location field of a symbolic PPU machine instruction optionally contains a location symbol. When 
the symbol is present, it is assigned the value of the location counter. 

The operation field of a symbolic PPU machine instruction contains a three-character name. 

The variable field contains one or two subfields. Each subfield contains an absolute or relocatable 
expression that reduces to a 6-bit, 12-bit, or 18-bit value. 

Designators used in this section are listed in table 9-1. 

Generally, the third character of the instruction mnemonic (N, D, M, C, or I) indicates the mode of 
addressing: 

N No operand address reference 

D Direct operand address: d contains operand 

M Memory address m or m + (d) contains operand 

C 18-blt constant 

I Indirect; operand address is (d) 
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TABLE 9-1. PERIPHERAL PROCESSOR INSTRUCTION DESIGNATORS 



Designator 


Use 


A 


18-bit A register 


c 


An expression that reduces to an 18-bit operand value. 


d 


A 6-bit operand or operand address expression. 


m 


A 12-bit expression value used with d or (d) to form an 18-bit operand or 12-bit 
operand address. 


P 


12-bit Program Address register 


Q 


12-bit Q register 


r 


An expression that reduces to a 6-bit value (-37g^ r< 37 g) 
specifying relative address or shift count 





Contents of a register or location 


(()) 


Refers to indirect addressing 



Some of the instructions provide similar functions using different modes of addressing. They can be 
grouped according to function as shown below: 



Function Description 

Data transmission The following instructions either load data into the A register or store 

data from it. A load instruction loads a 6-bit, 12-bit, or 18-bit value 
as indicated by the instruction; any remaining upper bits of A are zeroed, 
except for the LCN instruction for which remaining bits are set to one. 

A store instruction stores the lower 12 bits of the A register contents into 
a memory location indicated by the instruction. 

The contents of A are not altered. 



Instruction 


Octal Code 


Section 


LDN 


14 


9.2.3 


LCN 


15 


9.2.3 


LDC 


20 


9. 2.4 


LDD 


30 


9. 2.9 


STD 


34 


9. 2.9 


LDI 


40 


9. 2.10 


STI 


44 


9. 2. 10 


LDM 


50 


9. 2. 11 


STM 


54 


9. 2. 11 
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Function (cont'd) Description (cont'd) 

Arithmetic A PPU arithmetic instruction adds or subtracts a 6-bit, 12-bit, or 

18-bit quantity from the contents of the A register and enters the result 
in A. 



Instruction 


Octal Code 


Section 


ADN 


16 


9. 2. 3 


SBN 


17 


9. 2.3 


ADC 


21 


9.2.4 


ADD 


31 


9.2.6 


SBD 


32 


9.2.6 


ADI 


41 


9. 2.7 


SBI 


42 


9.2.7 


ADM 


51 


9. 2.8 


SBM 


52 


9.2.8 



Lc^cal A lexical instruction forms a logical value in A using the contents of A 

as one of the operands and a 6-bit, 12-bit, or 18-bit value indicated by 
the instruction as the second operand. When the second operand is 
fewer than 18 bits, the remaining upper bits of A are unaltered, except 
for the LPK instruction for which the upper 12 bits are zeroed. 

Formation of a logical difference is equivalent to setting each bit in A 
that is unlike the corresponding bit in the second operand. For example. 

Initial (A) =0101 
Operand =1100 

Final (A) =1001 

Formation of a logical product is equivalent to setting a bit in A when 
the original setting of the bit in A and the corresponding bit in the second 
operand are both one's. 

For example, 

Mtial (A) =0101 
Operand = 1100 

Final (A) =0100 

A selective clear sets a bit zero in the A register wherever a bit is set 
in the second operand. For example, 

Initial (A) =0101 
errand = 1100 

Final (A) =0001 
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Function (conf d) 



Description (cont'd) 



Logical (cont'd) Logical instructions include the following: 



Instruction 


Octal Code 


Section 


LMN 


11 


9.2.3 


LPN 


12 


9. 2.3 


SCN 


13 


9.2.3 


LPC 


22 


9. 2.4 


LMC 


23 


9.2.4 


LMD 


33 


9.2.9 


LMI 


43 


9.2,10 


LMM 


53 


9.2.11 



Replace A replace instruction performs an arithmetic operation and returns the 

results to the A register and the memory location from which one operand 
was obtained. The lower 12 bits of the result replaces the operand 
obtained from a memory location. Replace instructions include the 
following: 

Instruction Octal Code Section 



RAD 


35 


9.2.9 


AOD 


36 


9.2.9 


SOD 


37 


9.2.9 


RAI 


45 


9.2.10 


AOI 


46 


9.2.10 


SOI 


47 


9.2. 10 


RAM 


55 


9.2.11 


AOM 


56 


9.2.11 


SOM 


57 


9.2.11 



9.2.1 BRANCH INSTRUCTIONS 

For branch instructions, the r subfield is a numeric value that indicates the number of locations to be 
jumped (maximum 31). When r is positive (01 through STg), the jump is forward r locations. When r is 
negative (-763 through -408), ^^e jump is backward 778-r locations. In the following tests, negative 
zero (777777) is nonzero. For conditional instructions, when the test condition is true, the jump takes 
place. WTien the condition is not met, execution continues with the next instruction. 



NOTE 

The jump count must not be 00 or 77. If it is, execution loops on 
the jump instruction. 



The J option of the FPU instruction (section 4.3.3) and the FERIPi-i Instruction (section 4.3.4) cause the 
value of the location counter to be subtracted from the value of the symbolic address (tag) before it is 
placed in the d field of the object code instruction. 
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Formats: 



Dperation 


Variable 


Description 


Size 


Octal Code 


LJM 


m, d 


Long jump to m+(d); if d = 0, m is not 
modified 


24 bits 


01dm 


RJM 


m, d 


Return jump to m+(d); Store P+2 at m+(d) 
and jump to m+(d)+l. 


24 bits 


02dm 


JJN 


rt 


Unconditional jump to P+ r locations 


12 bits 


03d 


JJN 


tag 


Unconditional jump to tag 


12 bits 


03d 


5JN 


rt 


Zero jump; jump to P+r locations if 
(A) = 


12 bits 


04d 




tag 


Zero jump to tag 


12 bits 


04d 


JJN 


rt 


Nonzero jump; jump to P+r locations if 
(A) ^ 


12 bits 


05d 


UN 


tag 


Nonzero jump to tag 


12 bits 


05d 


>JN 


rt 


Positive jump; jump to P+r locations if 
{A)>0 


12 bits 


06d 


>JN 


tag 


Positive jump to tag 


12 bits 


06d 


IJN 


rt 


Minus jump; jump to P+r locations if 
(A)<0 


12 bits 


07d 


UN 


tag 


Minus jump to tag 


12 bits 


07d 



If PPU J or PERIPH J option has been selected, r is not valid. The contents of the variable field must 
be a symbolic address (tag). 



xamples: 



Code Generated 




LOCATION 


OPERATION 


VARIABIE COMMENTS 


] 




n 


18 ho 


TIGO 1^6? 






LJM 


STflPT ' 

1 


0271 nooo 








o,nTn j 








UJM 










7JN 


1 

1 


Q^?5 








f 


0Bf>7 






PJM 


t 


0726 






MJM 





I 



the above example^, the LJM instruction is at address 00143. TAGl is address 0012«, TAG2 has a 
ilue of 13g, TAGS has a value of 25g, and TAG4 has a value of 26 . 
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Code Generated 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 








18 |30 
















PPU 


4 










UJN 


TAGl 










7JN 


TAG3 


1 In this example, the UJN is at 








1 address 0040. TAGl is address 


0556 






NJM 




1 0010, TAG2 is 0011, TAGS is 












j address 0045, and TAG4 is 


060? 






PJN 




j address 0046. 


d7ur 






MJM 


TAGl 





9.2.2 SHIFT INSTRUCTION 

The SHN instruction shifts the contents of the A register right or left r places. If r is positive (+1 to 
+31), the shift is left circular r places; if r is negative (-31 to -1), the shift is end off r places to the 
right with no sign extension. No shift takes place when r is + 0. The assembler places the value of 
the r expression in the d field. If -31 >r >31 , the assembler generates an address error. 

Format: 



(Iteration 


Variable 


Description 


Size 


Octal Code 


SHN 


r 


Shift (A) by + (left) or - (right) r bits 


12 bits 


lOr 



Examples: 

1. Shift contents of A left circular 6 places 
Code Generated 



1006 

2. Shift contents of A right end off 6 places 
Code Generated 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


ho 
















^ 1 



1071 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


t 




11 


18 


i30 












SCNT 


SHN 


_ ^ 

-SCNT j 



9.2.3 NO ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, the contents of the d field are interpreted as a 6-bit 
positive operand. This mode eliminates the need fot storing many constants in core. 
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Formats : 



Operation 


Variable 


Description 


Size 


Octal Codp 


LMN 


d 


Logical difference (A)-d-*A 




XJLKX 


LPN 


d 


Logical product {A)*d— A 


12 bits 


12d 


SCN 


d 


Selective clear (A) 


12 bits 


13d 


LDN 


d 


Load d"* A 


12 bits 


14d 


LCN 


d 


Load complement d-*A 


12 bits 


15d 


ADN 


d 


Add (A)+d"-»-A 


12 bits 


16d 


SBN 


d 


Subtract (A)-d-*A 


12 bits 


17d 



Examples: 



Code Generated 




lOCATION 


OPERATION 


VASIABIE 


COMMENTS 


1 




II 


18 




1112 








12B 




1?07 






IPH 


7 




I3?l 






SCN 


210 




15 






SFT 


i^B 




IklS 






LDN 






1514 






LCN 






ifetri 








1 




1702 






sm 


2 





9.2.4 CONSTANT MODE INSTRUCTIONS 

In this mode, during instruction execution, the contents of the d and m fields are taken directly as an 
operand. This mode also eliminates the need for storing many constants. The assembler reduces 
absolute or relocatable expression c to an 18-bit value and stores the upper six bits in d and the lower 
12 bits in m. 
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Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


LDC 


c 


Load -*A 


24 bits 


20dm 


ADC 


c 


Add (A)+c —A 


24 bits 


21dm 


LPC 


c 


Logical product (A) *c -*A 


24 bits 


22dm 


LMC 




c 


Logical difference (A)-c -♦A 


24 bits 


23dm 



Examples: 

Code Generated 

2070 70T0 

2177 7T76 
2207 0707 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 ho 






LOC 


7070708 


1 ■ 

1 




VAL 







1 






ADC 


VAL-1 








LPC 


070707B 








SET 


0707078 








LMC 


MASK 


1 



70707 

2307 0707 
9.2.5 NO OPERATION INSTRUCTION 

The PSN instruction specifies that no operation is to be performed. It provides a means of padding 
a program. 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


PSN 




No operation (Pass) 


12 bits 


2400 



Example: 

Code Generated 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 !30 






PSN 


i . 

1 



Other octal operation codes (not generated by COMPASS) that act as pass instructions are: 

CYBER 170 Series, CYBER 70/ 
Models 72, 73. 74 and 6000 Series 



00 
25 



CYBER 70/Model 76 and 7600 

25 
26 
27 
75 
76 
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9.2.6 EXCHANGE JUMP INSTRUCTIONS {CYBER 170 SERIES, 
CYBER 70/MODEL 71, 72, 73, 74 OR 6000 SERIES) 

The EXN instruction transmits an 18-bit (absolute) address from the A register to the CPU with a signal 
notifying the CPU to execute an exchange jump. The address in A is the starting location of the 16-word 
exchange package which contains information about the CPU program to be executed. The 18-bit initial 
address must be entered in A before the EXN instruction is executed. The CPU replaces the file with 
similar information from the interrupted CPU program. The PPU is not interrupted. The EXN instruc- 
tion does not affect the monitor flag bit. 

The MXN instruction conditionally exchange jumps to the CPU and initiates CPU monitor activity. If 
the monitor flag bit is clear, this instruction sets the flag and initiates the exchange. If the monitor 
flag bit is set, this instruction acts as a pass instruction. The starting address for this exchange is 
the 18-bit address in the PPU A register. This address must be entered in A before the MXN instruc- 
tion is executed. 

Execution of MAN resembles MXN. However, the exchange package address is taken from the 18-bit 
Monitor Address (MA) register in CPU d, rather than from the PPU A register. 

In a system with dual central processors, d can be or 1 and specifies which CPU the exchange jump 
will interrupt. In single processor systems, this value is not interpreted. 



Formats: 



1 

Operation 


Variable 


Description 


Size 


Octal Code 


EXN 


d 


Exchange jump CPU d to (A) 


12 bits 


260d 


MXN 


d 


Monitor exchange jump CPU d to (A) 


12 bits 


261d 


MANt 


d 


Monitor exchange jump CPU d to (MA) 


12 bits 


262d 



Examples: 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 








11 


18 ho 










2601 






EXN 


1 1 
1 


2610 






MXM 


t 


2623 






HAN 


1 

1 



t CYBER 170 Series and CYBER 70/Model 71, 72, 73, and 74 only. 



9-10 



60492600 F 



9.2.7 READ PROGRAM ADDRESS INSTRUCTION 

(CYBER 170 SERIES , CYBER 70/MODELS 71, 72, 73, 74, AND 6000 SERIES) 



Tliis instruction transfers the contents of the CPU P register to the PPU A register; this allows the PPU 
to determine whether the CPU is in execution. In a dual central processor system, the lowest order bit 
of the instruction format specifies which CPU P register is to be examined. This bit is not interpreted 
for a single central processor system. 



Format; 



Operation 


Variable 


Description 


Size 


Octal Code 


RPN 


d 


Read program address CPU d -* A 


12 bits 


27 Od 



Example : 



Code Generated 
2700 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 Uo 














RPN 


: j 

1 



For the 6000 and CYBER 70 series, the largest value that (P) can be is 17 bits. An ECS transfer is ii 
progress when bit 17 of the A register is set. For the CYBER 170 series, the P register is 18 bits. 

9.2.8 6416 PPU INSTRUCTIONS 

COMPASS assembles the following instructions for execution on a 6416 computer system only. The 
ETN instruction initiates memory transfer operations by transmitting an 18-bit address from the 
PPU A register to the 6416 16K memory. This address points to a word having the following format: 



xo 


AO 


K 


59 36 18 






00 
/ 


V 

Starting Address 


Starting Address 




V - 

Word Ccxmt 





in Extended Core Storage in 16 K Memory 



Expression d of this instruction specifies the transfer to be performed: 

If d is 0, K words are transferred from ECS to 16K memory. 
If d is 1, K words are transferred from 16K memory to ECS, 

Note that addresses contained in the word are absolute addresses. Operating systems may require 
relocation (adding RA to an address) and field length testing, e. g. , Is address + RA > FL? The 
Exchange Jump package contains RA and FL values for central memory and for extended core storage. 
The 6416 has no hardware for automatic relocation and field length testing; it is therefore incumbent 
upon the program to perform these functions whenever required by an operating system. 
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The ERN instruction examines the status of the data trunk between 16K memory and the extended core 
coupler. If the data trunk is busy (a transfer is in progress), a 1 is placed in the most significant bit 
position of the A register. If the trunk is free (not busy), the A register remains cleared. The d 
portion of this instruction is ignored. 

After execution of this instruction the program would typically test the A register for a sign before 
executing an instruction that initiates an ECS operation. 



Formats : 



Qse ration 


Variable 


Description 


Size 


Octal Code 


ETN 


d 


Extended core transfer 


12 bits 


260d 


ERN 


d 


Read extended core coupler status 


12 bits 


27 Od 



Examples : 



Code Generated 




lOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




n 


18 ho 


2600 






ETN 


i — — 

1 


2700 






ERN 


1 
I 



9.2.9 DIRECT ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, the contents of the d field specify the address of the operand. 
During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 
specifies one of the first lOOg addresses in core memory (0000 - 0077g). During instruction execution, 
(d) is treated as a positive 12-bit quantity. 
Format: 



Gyration 


Variable 


Description 


Size 


Octal Code 


LDD 


d 


Load (d)-*A 


12 bits 


30d 


ADD 


d 


Add (A) + (d)-*A 


12 bits 


31d 


SBD 


d 


Subtract (A) - (d) -A 


12 bits 


32d 


LMD 


d 


Logical difference (A) and (d) -*-A 


12 bits 


33d 


STD 


d 


Store (A)— d 


12 bits 


34d 


RAD 


d 


Replace add (d) + (A)— d and A 


12 bits 


35d 


AOD 


d 


Replace add (d) + 1 -*d and A 


12 bits 


36d 


SOD 


d 


Replace subtract one (d) - 1— d and A 


12 bits 


37d 
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Examples : 



Code Generated 




lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


! 




11 


18 


iao 










301? 






LOO 


TAGl 




3103 






ADD 


TAG2-10B 




32U0 






SBO 






1327 






LMO 


T/VGH-IBB 




3«*01 






STO 


1 




35e;5 






RAO 






3612 






fiOO 


TAGl 




3713 






SOO 


TflGZ 





9.2.10 INDIRECT ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, d specifies an address, the contents of which specify the 
address of the desired operand. Thus, d specifies the operand address indirectly. 

During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 

specifies one of the first 100 addresses in core memory (0000 - 0077 ). 

8 o 

On the 7600 (or CYBER 70/Model 76), the address formed permits referencing of all memory locations 
but one (0000 - 7776.). 

o 

On a 6000 Series Computer System (as well as CYBER 170 Series or CYBER 70/Model 71, 72, 73 or 74) 
PPU, the address formed in indirect address mode permits referencing of all memory locations, 
including address 7777 . 

o 

Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


LDI 


d 


Load ((d))— A 


12 bits 


40d 


ADI 


d 


Add (A) + ((d))— A 


12 bits 


41d 


SBI 


d 


Subtract (A) - ((d))— A 


12 bits 


42d 


LMI 


d 


Logical difference (A) - ((d)) —A 


12 bits 


43d 


STI 


d 


Store (A)— (d) 


12 bits 


44d 


RAI 


d 


Replace add ((d)) + (A)— (d) and A 


12 bits 


45d 


AO! 


d 


Replace add one ((d)) + 1— (d) and A 


12 bits 


46d 


SOI 


d 


Replace subtract one ((d)) - 1 — (d) and A 


12 bits 


47d 
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Examples: 



Code Generated 




LOCATION 


OPERATION 


VABIABIE COMMENTS 




1 




II 


18 |30 


t*012 






LDI 


1 M J, 1 


'♦103 






flOI 


TAG2-1 Q ' 








COT 


rt o 1 








LMI 


TAGl+lSP 1 








STI 


1 1 








RAI 


55B 1 


t»612 






AOT. 


TAGl 1 


i»713 






SOI 


TAG? 1 



9.2.11 INDEXED DIRECT ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, the value formed by m+(d) is used as the address of the 
operand. During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit 
value that specifies one of the first lOOg addresses in core memory (0000 - OOTTg). The value of 
absolute or relocate-ble expression m is a 12-bit base address. 

NOTE 

The address formed in indexed addressing permits 
referencing of all memory locations but one 
(0000-7776g). Although m and/or (d) can have a 
value of 7777 Q, the computer system does not 
permit m+{d) to reference address 777 7 



When in indexed direct address mode, if d is nonzero the contents of address d are added to m to 
produce a 12-bit operand address (indexed addressing). If d is zero, m is taken as the operand address. 
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Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


LDM 


m,d 


Load (m+(d))-*A 


24 bits 


50dm 


ADM 


m, d 


Add (A) + (m+(d))-*A 


24 bits 


51dm 


SBM 


m, d 


Subtract (A) - (m+(d))-*A 


24 bits 


52dm 


LMM 


m, d 


Logical difference (A) - (m+(d))— A 


24 bits 


53dm 


STM 


m, d 


Store (A)— m+(d) 


24 bits 


54dm 


RAM 


ni, d 


Replace add (m+(d)) + (A)-*m+(d)and A 


24 bits 


55dm 


AOM 


m,d 


Replace add one (m+(d)) + l-*m+(d) and A 


24 bits 


56dm 


SOM 


Tn,d 


ileyl^ce subtract one (m+(d)) - l-^m+(d) 


24 bits 


57dm 



Examples: 

Code Generated 

5077 0203 
5106 0202 

5200 0202 
5315 700U 
SkiO 0272 
5500 03«t2 
5600 0173 
5712 0203 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




n 


)8 ho 








\ 






LDM 


TAGb,77B 1 






AOM 


TAG5,fa ] 






SfciM 


TAG5 1 






LMM 


70003,158 I 








f 

T A&5*-70B,TAGl-2 






RAM 


! 

Ift084-IAG5,0 1 






AOM 


-10B4-TA&6 ! 






SOM 


TAGofTAGl ^ 

1 



9.2.12 CENTRAL READ/WRITE INSTRUCTIONS 

(CYBER 170 SERIES, CYBER 70/MODELS 71, 72, 73, 74 OR 6000 SERIES) 

The CRD instruction transfers a 60-bit word from central memory to five consecutive PPU locations. The 
18-bit address of the central memory location must be loaded into A prior to executing this instruction. 
(Note that this is an absolute address.) The 60-bit v/ord is disassembled into five 12-bit words beginning at 
the left. Location d receives the first 12-bit word. The remaining 12-bit words go to successive locations. 
The contents of A are not altered. 

The CRM instruction reads a block of 60-bit words from central memory. The contents of location d give 
the block length. The 18-bit address of the first central word must be loaded into A prior to executing this 
instruction. (Note that this is an absolute address.) During the execution of the instruction, the contents 
of P go to processor address and P holds m. Also, the block length (from d) goes to the Q register where 
it is reduced by one as each central word is processed. The original content of P is restored at the end of 
the instruction. The new contents of P are fetched from word 0. If the read operation overwrote the 
contents of word 0, the restored value of P will be different from the original contents. 
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The contents of A are incremented by one to provide the next central memory address after each 60-bit 
word is disassembled and stored. The contents of the Q register are also reduced by one. The block 
transfer is complete when (Q)=0. The block of central memory locations proceeds from address (A) to 
address (A)+(d)-l. The block of processor memory locations proceeds from address m to m+5(d)-l. 

Each central word is disassembled into five 12-bit words beginning with the high-order 12 bits. The 
first word is stored at processor memory location m. The content of P (which is holding m) is advanced 
by one to provide the next address in the processor memory as each 12-bit word is stored. If P overflows, 
operation continues as P is advanced from 1111 ^ to 0000 . These locations will be written into as if 
they were consecutive. 

rhe CWD instruction assembles five successive 12-bit words into a 60-bit word and stores the word 
n central memory. The 18-bit address word designating the central memory location must be in A 
)rior to execution of the instruction. (Note that this is an absolute address. ) 

Location d holds the first word to be read out of the processor memory. This word appears as the 
ligher order 12 bits of the 60-bit word to be stored in central memory. The remaining words are taken 
rom successive addresses. 

rhe CWM instruction assembles a block of 60-bit words and writes them in central memory. The content 
>f location d gives the number of 60-bit words. The content of the A register gives the beginning 
;entral memory address. (Note that this is an absolute address. ) During the execution of this instruction 
P) goes to processor address 0, and P holds m. Also, (d) goes to the Q register, where it is reduced 
•y one as each central word is assembled. The original content of P is restored at the end of the 
nstruction. 

rhe content of P (the m portion of the instruction) gives the address of the first word to be read out of 
he processor memory. This word appears as the higher order 12 bits of the first 60-bit word to be 
tored in central memorj^ 

:'he content of P is advanced by one to provide the next address in the processor memory as each 
2-bit word is read. If P overflows, operation continues as P is advanced from 7777 to 0000 . 
^hese locations will be read from as if they were consecutive. ^ 

is advanced by one to provide the next central memory address after each 60-bit word is assembled. 
lIso, Q is reduced by one. The block transfer is complete w^hen (Q)=0. 



'ormats : 



Operation 


Variable 


Description 


Size 


Octal Code 


CRD 


d 


Central read from (A) to d 


12 bits 


60d 


CRM 


m,d^ 


Central read (d) CM words beginning 
at CM ( A)-^PPU m 


24 bits 


61dm 


CWD 


d 


Central write from d to (A) 


12 bits 


62d 


CWM 


m,d^ 


Central write (d) words beginning 
at FPU m-^ CM (A) 


24 bits 


63dm 



Expression d is required. 
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Example: 

Code Generat ed 
6015 

6125 001? 
623? 

6350 0012 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




11 


18 bo 






CRO 


156 


f 








CRM 


TAGl ,25B 










cwo 


328 










CWM 


TAGl, 508 







9.2.13 I/O BRANCH INSTRUCTIONS 

(CYBER 170 SERIES, CYBER 70/MODELS 71, 72, 73, 74, AND 6000 SERIES) 

The following instructions are conditional long jump instructions, each of which tests for a condition 
on channel d. When the condition is true, the jump to address m takes place. When the condition is 
not met, execution continues with the next instruction. The d expression is required. 



For the FJM instruction, an input channel is full when the input equipment has sent a word to the channel 
register and sets the full flag. The channel remains full until the PPU accepts the word and clears the 
flag. An output channel remains full when a PPU sends a word to the channel register and sets the 
full flag. The channel is empty when the output equipment accepts the word and notifies the PPU. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


AJM 


m,d 


Jump to m if channel d active 


24 bits 


64dm 


IJM 


m,d 


Jump to m if channel d inactive 


24 bits 


65dm 


FJM 


m,d 


Jump to m if channel d full 


24 bits 


66dm 


EJM 


m,d 


Jump to m if channel d empty 


24 bits 


67dm 



Examples : 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 




1 




II 


18 |30 


6«»02 0012 






A JH 


TAGl, 2 1 


6502 0013 






IJM 


TflG2,CHAN-2 | 


660«f 0025 






FJM 


TAG3,^» 1 


6701* 0026 






EJM 


TAG<t,CHAN 1 
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9.2.14 I/O BRANCH INSTRUCTIONS (CYBER 70/MODEL 76 AND 7600) 



The following instructions are conditional long jump instructions each of v/hich tests a condition on 
channel d. When the condition is true, the jump to address m takes place. When the condition is not 
met, execution continues with the next instruction. These instructions are exclusively 7600 PPU 
instructions. The d expression is required. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


FIM 


m,d 


Jump to m on channel d input word flag 


24 bits 


60dm 


EIM 


m,d 


Jump to m if no input word flag on channel d 


24 bits 


61dm 


IRM 


m,d 


Jump to m on channel d input record flag 


24 bits 


62dm 


NIM 


m,d 


Jump to m if no input record flag on 
channel d 


24 bits 


63dm 


FOM 


m,d 


Jump to m on channel d output word flag 


24 bits 


64dm 


EOM 


m,d 


Jump to m if no output word flag on 
channel d 


24 bits 


65dm 


ORM 


m,d 


Jump to m on channel d output record flag 


24 bits 


66dm 


NOM 


in,d 


Jump to m if no output record flag on 
channel d 


24 bits 


67 dm 



Examples: 

Code Generated 

6005 1^65 
6102 1"«65 
6?01 1366 

670U 1766 
6^*15 7000 
6«^00 1525 
6601 1256 
6705 1366 





lOCATION 


OPERATION 


VAKIAIIE COMMENTS 


I 




11 


18 iao 






FIM 


TAG5,5 j 






flM 


TflG5,2 1 






IRM 


TAG6,1 






SP-T 


If 






MIM 


TflG6,CHfiN ' 






FOM 


70008»15B 1 






EOM 


l<»0O+T4G5,0 j 






ORM 


-10nR+TAG6»rHAM-3 






NOM 


TAG6,CHftN-H | 
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9.2.15 A REGISTER INPUT/OUTPUT INSTRUCTIONS 



The following instructions transfer a woi'd to or from channel d and the lower 12 bits of the A register. 

On the CYBER 70/Model 76 or 7600, the IAN instruction is not executed until the input channel d word 
flag is set. If the flag is not set when the instruction is read, execution halts until an external signal 
sets the flag. The input channel d record flag does not affect the IAN execution. The IAN instruction 
clears the input channel d word flag and record flag and transmits a resume signal over the input cable 
after the word is entered in the A register. 

On the CYBER 70/Model 76 or 7600, the OAN instruction is not executed while the output channel d 
word flag is set. If the flag is set, execution stops until an external resume signal clears the flag. 
This instruction sets the output chamiel d word flag and transmits a work pulse over the output channel 
cable. 

On a CYBER 170 Series, CYBER 70/Model 71, 72, 73, or 74 or 6000 Series machine, executing 
either of these instructions when the channel Is inactive causes the peripheral processor unit to become 
inoperative until some other peripheral processor activates the channel or the system is deadstarted. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


IAN 


d 


Input : channel d to A 


12 bits 


70d 


OAN 


d 


Output: (A) to channel d 


12 bits 


72d 



Examples: 

Code Generated 
7 00 3 





lOCATION 


OPERATION 


VARIABLE 


COMMENTS 


I 




)) 


18 


[30 














IAN 

OAN 


1 r- 

CHAN 1 



9.2.16 BLOCK INPUT/OUTPUT INSTRUCTIONS 

The following instructions transfer a block of 12-bit words on channel d to or from a starting FPU memory 
location specified by m. The number of words transferred is specified by the contents of the A register 
which is reduced by one as each word is transferred. The operation is completed when (A)=0 or the channel 
becomes inactive (CYBER 170 Series, CYBER 70/Model 71, 72, 73, 74 or 6000 only). 

On a CYBER 170 Series, CYBER 70/Model 71, 72, 73, 74 or 6000 Series machine, the input operation is 
complete when the contents of A equal or the data channel becomes inactive. If the operation is 
terminated by the channel becoming inactive, the next location in the processor memory is set to all 
zeros. The word count is not affected by this empty word. Therefore, the contents of the A register give 
the block length minus the number of real data words actually read in. 

During execution of either of these instructions, address 0000 temporarily holds P, while the P register 
holds m. The contents of P advance by one to give the address for the next word as each word is 
transferred. 

if a read operation overwrites word (address 0000), the restored value of P may be different from the 
contents of P before the operation. 
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NOTE 



I If this instruction is executed on a CYBER 170 Series, 

CYBER 70/Model 71, 72, 73, or 74 or 6000 Series machine when 
the data channel is inactive, no operation is accomplished and 
the program continues at P + 2. ilowever, the location specified 
by m is set to all zeros for the lAM instruction. 

On a CYBER 70/Model 76 or 7600, the lAM instruction is not executed until the input channel d word flag 
is set. If the flag is not set when the instruction is read, execution halts until an external signal sets the 
flag. The presence of an input channel d record flag is ignored for the first word of the block but 
terminates the block input at any word after the first. In this case, the next location in the FPU block 
input storage area contains a noise word; any remaining locations are unaltered. Note that the storage 
location can be incremented through location 77768 to OOOg on a 7600 (or CYBER 70/Model 76), or 
I location 7777 through 0000 on a 6000 Series machine (or a CYBER 170 Series, CYBER 70/Model 71, 72, 73, 
or 74), which could destroy existing data or a program. 

On a CYBER 70/Model 76 or 7600, the 0AM instruction is not executed until the output channel d word 
flag is cleared. If the flag is set when the instruction is read, execution halts until a resume pulse clears 
the flag. An output channel d record flag does not affect 0AM execution. 



Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


JAM 
OAM 


in,d t 
m,d T 


Input: (A) words to m from channel d 
Output: (A) words to channel d from m 


24 bits 
24 bits 


71dm 
73dm 


tExpression d is required. 



Examples: 



Code Generated 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


71C7 1364 
77Vk l3fSi4 


I 




U 


18 130 






lAM 


TAG, 3 { 
TAG, 4 1 



9.2.17 SET OUTPUT RECORD FLAG INSTRUCTION {CYBER 70/MODEL 76 AND 7600) 

The RFN instruction sets the output channel d record flag and transmits a record pulse over the cable. 
The instruction ignores the previous status of the channel d flags; the instruction is executed even if the 
output channel d record flag is set. 



Format: 



Qse ration 


Variable 


Description 


Size 


Octal Code 


RFN 


d 


Set output record flag on channel d 


12 bits 


74d 
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Example : 

Code Genera ted 

7kQb 





LOCATION 


OPERATION 


VARIABIE 


COMMENTS 


1 




It 


18 i 30 












RFM 


6 


1 
i 



9.2.18 CHANNEL FUNCTION INSTRUCTIONS 

(CYBER 170 SERIES, CYBER 70/MODELS 71, 72, 73, 74, AND 6000 SERIES) 

The ACN instructica activates the chaanel specified by d. This instruction must precede the IAN, lAM, 
OAM, or OAN instructions. Activating a channel alerts the input/output equipment for the exchange of 
data. Activating an already active channel causes the PPU to become inoperative until another PPU or 
an external equipment deactivates the channel, or the system is deadstarted. 

The DCN instruction deactivates the channel specified by expression d. It stops the input/output 
equipment and terminates the buffer. Deactivating an already inactive channel causes the PPU to 
become inoperative until deadstart or until the channel is activated. Avoid disconnecting the 
channel before first sensing for channel empty, deactivating a channel before stopping the associated 
processor, or deactivating a channel before placing a useful program into the associated processor. 
After deadstart, PPUs wait on an input channel. Deactivating a channel after deadstart causes an 
exit to address 0001 and execution of the program. 

The FAN Instruction sends the external function code from the lower 12 bits of the A register on 
channel d. 

The FNC instruction sends the external function code specified by m on channel d. For this instruction, 
expression d is required. 

Execution of a FAN or FNC instruction v/hen the channel is active causes the PPU to become inoperative 
until another PPU or an external equipment deactivates the channel, or the system is deadstarted. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


ACN 


d 


Activate channel d 


12 bits 


74d 


DCN 


d 


Disconnect channel d 


12 bits 


75d 


FAN 


d 


Function (A) on channel d 


12 bits 


76d 


FNC 


c,d 


Function c on channel d 


24 bits 


77dm 



Examples : 



7i»05 
76C5 

7705 0020 



LOCATION 



OPERATION 



ACN 
DCN 
FAN 
FNC 



VARIABLE 



18 



5 

CHAN 

CHAN4-1 

20B,5 



COMMENTS 



30 
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9.2.19 ERROR STOP INSTRUCTION (CYBER 70/MODEL 76 AND 7600) 



The ESN instruction halts execution of the peripheral processor prc^ram and indicates a program 
error condition to the monitor control unit. The PPU must be restarted by a deadstart sequence from 
the MCU, only. 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


ESN 


d 


Error Stop 


12 bits 


7700 



Example: 

Code Generated 

7700 





lOCATlON 


OPERATION 


VARIABIE 


COMMENTS 


1 




11 


18 ho 














f-'SN 


1 ^ 

1 
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PROGRAM EXECUTION 



10 




COMPASS can be called from the library and placed in execution through a COMPASS compiler caU 
statement or through an IDENT statement (section 4.2.1) in a FORTRAN source deck. Ordinarily, when 
COMPASS is called through FORTRAN, the parameters specified on the statement apply also to COMPASS. 



10.1 CONTROL STATEMENTS 

NormaUy, assembly of COMPASS source programs or the execution of CPU binary object decks is done 
from a job file. A file is usuaUy submitted in the form of card decks or card images. The first section of 
the fae must contain the control statements described in this section. Other optional statements are 
described in the operating system reference manual. Following the control statement section are one or 
more sections containing source statements and data. 

A control statement begins with the first nonblank character. A comma or a left parenthesis or blank 
rnarks the beginning of a parameter string. Parameters in the string are separated by commas. A period or 
right parenthesis terminates a parameter string. Comments optionally follow the terminator. Within the 
parameter strings, blanks are ignored. Ordinarily, a parameter can contain only letters and digits. Wlien a 
parameter is enclosed between dollar signs, all characters are permitted and blanks are not ignored. Within 
such a dollar-sign delimited parameter, two consecutive dollar signs represent a single dollar sign. 



10.1.1 JOB STATEMENT 

A job statement of the following format inust be the first statement in the deck. The parameters following 
name can be in any order or can be omitted. For any omitted field, a default value is supplied which is an ° 
installation option. 

Format: 





name, Tt,E Clem. 



name 1 through 7 letters or digits by which the job is identified. 
The first character must be a letter. 

Tt CPU time limit in seconds (NOS/BE 1, SCOPE 2: 1 through 777778; NOS 1: 1 through 

32760io). Must be sufficient to process all control statements for the job, including 
assembly and execution. 

EClcm (NOS/BE 1, SCOPE 2 only). Estimate of maximum amount of LCM or ECS in octal 
thousands, required for assembly or execution (1 through 14008). 

COMPASS notes storage used in the job dayfile. For subsequent runs, the field lengths can be decreased 
accordingly. 
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Examples: 

JOBl, TlOO, EC30. 
I^TESTER. 







10.1.2 COMPASS CALL STATEMENT 

The following statement causes the COMPASS assembler to be loaded from the library and executed. 
Parameters specify modes and files. 

Format: 



COMPASS(p^,P2,...,p^) 



The optional parameters, p, may be in any order within the parentheses. A parameter can be omitted or 
can be in one of the following forms: 

mode 

mode=0 

mode=lfn 

Mode is one or two characters as described below; If n is a 1 through 7 character name of a file or a 
character string. 

Mode S ignificance 
A - Abort mode. 

A Abort job at end of run if any assembly errors occurred. 

omitted Do not abort job for assembly errors. 

B - Binary output. 

omitted or B Binary on the load-and-go file (LGO). 

B=0 No binary output. 

B=lfn Binary on the named file. 

BL - Burstable listing. Generates output listing easily separable into components: 

• Issues page ejects between load map, source code, and cross reference 
map. 

• Assures an even number of pages (page parity) for each program unit 
listing, issuing a blank page at end if necessary. 

omitted or BL=0 Generates listings in compact format. Page ejects issued only before new 
subprograms. 
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Mode 



Significance 



D - Debug mode. 
D 



E - 



G - 



Binary is generated on the file indicated by B parameter in spite of assembly 
errors and regardless of the abort mode (A parameter). The A parameter is 
ignored when the D parameter is selected. 

D is ignored if B=0. 

omitted Assembly errors inhibit binary output. In abort mode (A parameter present), 

no binary output is written at all for a subprogram containing assembly errors. 
Otherwise (A parameter omitted), the message ERRORS IN ASSEMBLY is 
written to the file indicated by the B parameter for each subprogram 
containing assembly errors. 

Error list. Suppressed if full list is directed to the same file or if no assembly errors occur. 
However, if the full list and error list are on different files (for example, the full list is written to 
OUTPUT and the error list is written on the named file), the error list will contain all statements 
having error flags. If an error line was generated by a macro call, the macro call can also appear in 
tlie error list. Specification of both the E and the parameter results in a control statement error. 



omitted 
E 

E=lfn 
E=0 



Error list on file OUTPUT. 
Error list on file ERRS. 
Error list on named file. 

No error list is generated (equivalent to directing error list to the same file as 
fuUlist). 



FORTRAN mode. Establishes value of special element *F. 



omitted or F 

F=number 

F=name 



Get system text, 
omitted or G=0 
G 

G=lfn 
G=lfn/ovl 



*F is 0. 

*F is number (one decimal digit). 

*F is a number corresponding to name as follows: 

COMPASS = 
RUN = 1 
FTN = 2 

Load no system text from a sequential binary file. 

Load the first system text overlay, if any, from file named SYSTEXT. 

Load the first system text overlay, if any, in the specified sequential binary 
file. 

Search the specified sequential binary file for a system text overlay whose 
name is ovl and load the first such overlay. 
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Mode Significance 
I - Source of assembler input. 

omitted Source deck is on INPUT file. 

I Source deck is on COMPILE file in either compressed or expanded format. 

1=0 Illegal. 

I=lfn Source deck is on named file. 

L - Full list. 

omitted or L List output on OUTPUT file. 

L=lfn List output on named file. \Vlien the full list is on a different file than the 

short list, the listing for each subprogram is a separate section beginning with 
a one-word header consisting of an asterisk and the first six characters of the 
subprogram name. This header identifies the subprogram as a convenience for 
sorting and cataloging. For ease in bursting listings between subprograms, a 
blank page will be used, if necessary, to ensure an even number of pages per 
subprogram. Also see O option. 

L=0 No full list will be generated. 

LO - List options. Selects or deselects a maximum of nine of the list options A, B, C, D, E, F, G, L, M, N, 
R, S, T, or X. 

omitted or LO=0 Same as selecting B, L, N, and R only. 

LO Selects list options C, F, G, and X, and deselects R. 

L0=ciC2...Cn A list of up to nine characters. Inclusion of B, L, N, or R deselects the 

corresponding option. Otherwise, inclusion of a character selects the option. 
For options, refer to LIST pseudo instruction, section 4.11.1. 

L0=$$$$ Selects aU list options. 

ML - Initial Value of MODLEVEL Micro. 

omitted or ML MODLEVEL is defined equal to JDATE at the start of each assembly. 

ML=string MODLEVEL is defined as string (nine characters maximum) at the start of 

each assembly. 

N - No eject. This parameter has been obsoleted by the BL parameter. 

O - Short list. Suppressed if fuU list is directed to the same file or if no assembly errors occur. 

However, if the fuU list and short list are on different files (for example, the full list is written on 
OUTPUT and the short list is written on the named file), the short list will contain all statements 
having error flags. If an error line was generated by a macro call, the macro call may also be in the 
short list. Specification of both the O parameter and the E parameter results in a control statement 
error. 

omitted or O List output on OUTPUT file. 

0=lfn List output on named file. 

0=0 No short list will be generated (equivalent to directing short list to the same 

file as full list). 
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Mode Significance 
P - Continue page. 

P Page numbering continues from subprogram to subprogram. 

omitted Page numbering begins with 1 at the start of each subprogram. 

PC- Initial Value of PCOMMENT Micro. 

omitted or PC PCOMMENT is defined as 30 blanks at the start of each assembly. 

PC=string PCOMMENT is defined as string at the start of each assembly. Characters are 

truncated from the right or blanks are appended to the right, as necessary, so 
that the length of the micro value is exactly 30 characters. 

PD - Print Density. Print density of six is assumed upon entry. Listing control is changed only when print 
density of 8 is requested, then returned to 6 when finished. 



PD=6 

PD=8 or PD 

PD=other or 
omitted 

PS - Page Size. 

PS=x 

PS=other or 
omitted 



S - 



System Text Name, 
omitted 

S=0 
S 

S=ovl 
S=lib/ovl 



Print density is six lines per inch. 

Pring density is eight lines per inch. 

Print density defaults to IP.PD lines per inch. 

Page size is x lines per page. Acceptable values of x are 4 <x <99. 

If PD is not specified, page size defaults to IP. PS lines per page. If PD is 
specified, page size defaults to PS=(PD*IP.PS)/IP.PD. 



If there are no G parameters other than G=0, load the overlay named 
SYSTEXT from the job's current global library set. 

Load no system text from a library. 

Load system text overlay named SYSTEXT from job's current global library set. 

Load the system text overlay named ovl from the job's current global library 
set. 

Load the system text overlay named ovl from the library named lib, which may 
be a user library file or a system library. 



X - 



Overlay residence in user libraries is not currently supported by NOS. 
Source of external text (XTEXT) when location field of XTEXT pseudo instruction is blank, 
omitted External text OLDPL file. 

X=lfn External text on named file. 

X=0 lUegal. 
X External text on OPL file. 
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Examples: 



COMPASS(B,D,S=OVI) 



COMPASS(LO=ASGXD) 



COMPASS. 



Reads source from INPUT, writes the binary output to LGO, 
and the listing to OUTPUT. Assemble in debug mode with 
system text from overlay OVI in the global library set. 

Disables LIST pseudo instruction and sets LIST options 
A, S, G, X, and D. 

Uses the standard default options. 



MULTIPLE SYSTEM TEXT OVERLAYS 

COMPASS 3 allows up to seven system text overlays to be used for an assembler run. They are specifiea oy 
G and S parameters on the COMPASS control statement. Each G parameter (except G=0) specifies loading 
of a system text overlay from a sequential binary file, and each S parameter (except S=0) specifies loading 
of a system text overlay from a user library file or a system library. The G and S parameters can be used 
in any combination and in any order, and can be intermixed freely with other parameters, provided the 
total number of system text overlays specified does not exceed seven. COMPASS loads the system text 
overlays in the order in which the G and S parameters occur on the COMPASS statement. If a system 
macro, micro, or symbol is defined by more than one system text, only the last definition is used. S=0 has 
no effect if there are any other S or G parameters. 



Examples: 



COMPASS(I, S, S=PFMTEXT, G^MYTEXT) 



Reads source from file COMPILE and gets system 
text from overlays SYSTEXT and PFMTEXT in the 
global library set, and from the local file MYTEXT. 



COMPASS(G=FILE/SCPTEXT,S=MYLIB/TEXT) 



Get system text from overlay SCPTEXT 
on the file FILE, and from overlay TEXT 
in library MY LIB. 



10.1.3 LGO CONTROL STATEMENT 

An LGO control statement calls for the loading and execution of CPU binary output produced by the 
assembler unless the B option on the COMPASS control statement is set to or to some other file name. 
When binary output is on some file other than LGO, the statement is replaced by a program call statement 
for that file. The file is automatically rewound before loading. The LGO file is temporary; it is released 
at job termination. 

Formats: 



LGO(p^,P2,P3...«.Pj^) 



or 



LGO. 



10.1.4 PROGRAM CALL STATEMENT 

The program call statement directs the operating system to search for a file or CPU program that has the 
specified name, load it into central memory (CM or SCM), and execute it as a CPU program. 
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Formats: 



name(p^,P2,...,p^) 
^ name. 



name Program name. 

Pi Parameters in a format acceptable to the program being called. 

When the operating system locates the file, it rewinds and loads the file. When loading is complete, it 
executes the program as a CPU program. 



10.1.5 7/8/9 CARD 

A card with rows 7, 8, and 9 punched in column one separates sections in the job deck. The level is 
assumed zero unless columns 2 and 3 contain an octal level number punched in Hollerith code. The 
remaining columns optionally contain comments. 

As an example, a deck consisting of a control statement section and a COMPASS source input section 
would include two 7/8/9 cards. The first terminates the control statements and the second terminates 
COMPASS input. A 7/8/9 card of level 17 is interpreted by the operating system as a 6/7/8/9 card. 



10.1.6 6/7/8/9 CARD 

A card with rows 6, 7, 8, and 9 punched in column one signals the end of the job deck. Columns 2 through 
80 optionally contain comments. 



10.1.7 USER CONTROL STATEMENT {NOS 1 ONLY) 

The user control statement format is: 

^ 

USER, usernam, passwrd, famname. 

usernam User number or name 

passwrd User password 

famname Name of user permanent file device family name 



The USER statement, required by NOS 1, follows the job control statement and specifies user access 
information. The user name is used in system bookkeeping and defines the user's file catalog area. The 
user can specify a different permanent file catalog during job processing by issuing another USER control 
statement. 
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10.2 SAMPLE DECKS 

The following job calls for assembly of the source program and execution of the binary object program 
produced by the assembly. The USER control statement (for NOS 1 only) provides required user access 
information. COMPASS reads source statements from file INPUT, v/rites the listing on OUTPUT, and 
writes a binary object deck on file LGO. Control statement LGO calls for execution of the binai-y object 
program, which obtains its data from file INPUT. 



Subprogram 
Test 



Control 
Section 



Data for 
Execution 



J. 



z 



END TEST 



IDENT TEST 



Z5 



/ LGO. 
/ COMPASS. 



CHARGE statement. 



/ USEP statementT 
SAMPLE, TIOO. 
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In the following job, the COMPASS assembler is called twice. During the first assembly, binary object 
decks for subprograms TESTl and TEST2 are written on file LGFILEl. The source decks for these 
subprograms are in the second section of the INPUT file. During the second assembly, COMPASS writes a 
binary object deck for subprogram CD A on file LGFILE2. Each assembler run produces a full listing. 
Following the second assembly, LGFILE2 is repositioned to the beginning of the file. Then, the COPYBR 
program is called to copy the contents of LGFILE2 to a punch file (PUNCHB). The LGFILEl statement 
then calls for the loading and execution of subprograms TESTl and TEST2 from LGFILEl. Following 
successful execution of the subprograms, the file is rewound and copied to the punch file, after which the 
job terminates. 




Data for execution 



Subprogram CDA 



y aibprograni TEST2 

y Subprogram TESTl 



^ ( C0PYBR(LGFILE1, PUNCHB) 

{ REWIND (LGFILEl) 



f LGFILEl. 
( COPYBR(LGFILE2, PUNCHB) 



( REWIND(LGFILE2) 



( COMPASS (B=LGFILE2) 



( COMPASS(B=LGFILEl) 



SAMPLE, T500, EC50. 



Control 
Section 
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In the following example, the IDENT statement causes FTN to call COMPASS to process the COMPASS 
?oMo ^Sf- ^^'^ COMPASS END statement is not followed by another IDENT statement, then 
COMPASS returns control to the compiler that called it. 




IDENT begins in 
column 11 



The following sample programs illustrate how to assemble and use a system text overlay. 



I 

it 





IDtNT 


MYTLXT 




STKXT 




ONt 
HALf- 


bUU 
tQU 


i CONSTANT ONE 
JO PUS CONSTANT 


SHI^ T 


MACRO 


ALMHA,ritTA POSITIONING MACRO 




IFC 
SA^ 


Nh » tALPHA$X2$» 1 
ALPHA 




IFC 
SBir 


Nt »i8hTMiB2S* 1 
dL r A 




LXh 






t. MUM 






tNU 
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IDtNT 
tNTRY 
bST 



TEST 
TEST 



b I 1 U I) U i 


Tt-ST 


5bi 


ONL 


CONSTANT ONt FROM 


TtXT 


b 1 <^ c u u 1) n <^ ♦ 




SA2 


iNdUF 


PICK UP VALUE FROM 


STORAGE 






SHIF T 


X£?»HALF 


POSITION . WORD IN 


Xb 


bibOoaOOOb ♦ 




SAfo 


OUTtJUF 


Rt I URN NF W WORD TO 


STORAGE 






LNDHUN 








I 




BSS 








1 


OuTbUF 


BSS 


i 










tNO 


TLST 







The deck for this job could be set up as follows: 



/ ■ 

6 


7 , 1 


» r ■ — 






{ IDENT TEST 









8 



IDENT MYTEXT 



9 { COMPASS (G=MYTEXT, S) 

/ COMPASS(S=0,B-i\IYTEXT) 



TEXT,T17. 
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This section describes assembly listing format. Control of the contents of the listing is described in 
section 4. 11 Listing Control, and in section 10. 1. 2 COMPASS Call Statement. 



n.l PAGi KiADil^G 

Each page of the assembly listing contains a title line and a subtitle line in the following format: 



title 


COMPASS Version 


date 


time 


PAGE X 


subtitle 


sub- sub 
title 


block 
name 


symbol 
qual 





title Up to 62 characters taken from the first TITLE pseudo instruction or from a 

TTL pseudo instruction or, in lieu of these, from the DDENT instruction 

date Date of assembly 

time Time of assembly in hours, minutes and seconds 

PAGE X Page number of listing. Pagination begins with 1 for each END instruction 

unless the P option is selected on the COMPASS control statement 

subtitle Up to 62 characters taken from second and subsequent TITLE pseudo 

instructions or a CTEXT pseudo instruction 

sub-subtitle Up to 10 characters taken from the most recent EJECT, SPACE, TITLE, or 

TTL pseudo instruction or the location field of an ES or PS machine instruction. 
If the instruction that introduces the new sub- subtitle also causes a page eject, 
the instruction immediately follows the heading (assuming the C list option is 
also selected). 

block name Name of the block in use at beginning of page 

symbol qual Qualifier in use (see QUAL pseudo instruction) 



11.2 HiADii INFOtMMiON 

The first page of the assembly listing for each subprogram contains a summary of binary control cards 
(optional), a list of all the blocks established for the subprogram, and lists of entry points and 
external s3nnbols. 

11.2.1 BINARY CONTROL CARD SUMMARY 

A binary control card summary in the following format is generated /or each EDENT instruction when the 
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COMPASS control statement or the LIST instruction selects the B list option: 
ADDRESS LENGTH BINARY CONTROL CARDS 



iddr. 



iddr. 



binary card^ 
binary cardg 



iddr^ 



n 

(feop) 



binary card^j^ 
END card or blank 



binary card. 



addr. 



eop 



ieop 



The binary card that caused generation of the binary for the overlay, partial 
binary, or subprogram. The list includes SEG, SEGMENT, and IDE NT instruc- 
tions. 

The central memory or peripheral processor memory origin address for the 
subprogram, overlay, or partial binary written out as a result of the binary 
card. 

The octal length of the subprogram, overlay or partial binary, in central 
memory words for a central processor assembly, or in peripheral processor 
words for a peripheral processor assembly. 

The octal central memory or peripheral processor address for the end of the 
program unit begun by the previous IDE NT. 

The octal length in central memory words of a peripheral assembly; not present 
in a listing of a central processor assembly. 



Examples: 



flOORESS 

372 
5633 
7075 
132i»2 
20^37 
22811 



LENGTH 
271 

52%1 
12%2 

5175 

1352 



Bin km CONTROL CAPOS. 

lOEMT COHPASS, LOVER, CHP 

SEG 

SEG 

SEG 

SEG 

SEG 

PNO COHPASS 



ADDRESS LEN6TH BINARY CONTROL CARDS, 

e 7761 IDENT OSD»0 

7761 (1462) 



1-2 
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n. 2.2 BLOCK USAGE SUMMARY 

A block usage summary of the following format is generated in the assembly listing under control of the 
B list option: 



BLOCKS 

namCj^ 

name^ 



TYPE 



ADDRESS 
baddrj^ 
baddr„ 



LENGTH 



name„ 



bi 



n 

name. 



type 



baddr. 
I 

length. 
Examples: 



baddr. 



Name of the block used in the subprogram, as follows: 

PROGRAM* For a relocatable assembly, indicates the zero block. For an 
absolute assembly, the first PROGRAM* indicates the absolute 
block, the second indicates the default symbols block. 

ABSOLUTE* Appears in a relocatable assembly only and indicates the use 
of an absolute block. 

LITERALS* Identifies the literals block. 

other Identifies a local, labeled common, or blank common block. 

The type of the block as follows: 

ABSOLUTE All addresses in the block are relative to absolute zero. For 
an absolute asembly, all blocks are ABSOLUTE. 

+LOCAL Addresses in the block are relative to the origin assigned to 

block zero. The + is present for an ECS/LCM block. 

+COMMON Addresses in the block are relative to the origin of the common 
block. The + is present for an ECS/LCM block. 

Beginning address of the block according to type. 

Number of words in the block. 



BLOCKS 


TYPF 


AP PRESS 


LENGTH 




fif^SOLUTE 





SkiS 


LITERALS* 


ABSOLUTE 




215 


CONTROL 


ABSOLUTF 


56:»3 




PSPUDO 


ABSOLUTE 


7075 




SUBS 


ABSOLUT^ 




5175 


BUFFERS 


ABSOLUTF 


ZQk37 


111«»0 
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BLOCKS 


TYPE 


ADDRESS 


LFNGTH 


ABSOLUTE* 


ABSOLUTE 





62 


PROGRAM* 


LOCAL 





35 


OATAl 


LOCAL 


35 


1 


LCff 


♦LOCAL 





5 


TABLE 


♦LOCAL 


5 


5 


TABLE 


4-COHMON 





123 


TABLE 


LOCAL 


36 


1 


TABLE 


COMMON 





1 


// 


COMMON 





1000 



n.2.3 ENTRY POINT LIST 

f the subprogram declares entry points, a list of entry point symbols in the following format follows the 
)lock usage summary. 



ENTRY POINTS. 

sym^^ *+addr j^+block J 

syra^ *+addr2+block2 



sym^^j*+addr^^j+bloek^^j 
sym^^2*-'^^^n+2'"^^°^^n+2 



^y^2n+l*'"^^'^''2n+l'^^°°^ 



2n+l 



^y^2n+2*-*-^^^^2n+2-*^°^^2n+2 



sym *+addr +block 
n n n 



sym2^*+addr2^4block2^ 



sym„ *+addr„ +block- 
3n 3n 3n 



7here n is one-third the number of entry points. The asterisk to the right of sym. is present if sym, is a 
londitional entry point (declared by ENTRYC). The + to the left of addr. is present if block, is an E(3s/LCM 
•lock. The + to the right of addr. is present if addr is relocatable. BloV;k. is blank or a common block 
:ame surrounded by slashes. ^ ^ 

f the symbol is undefined, addr. is *******. 
)xample: 

:ntry points. 



;NAPi 
;NAPa 
;nap3 

lUMPVEC 

lEGIN 

JYTESIZ 



13i*54. CALL 72* 

1352* GOTO 456* 

13574- IF 22<*^ 

0+/JUMPVEC/ LABEL 372* 

0* READ i*35* 

6 RECORD 2<»-i-/DATA/ 



REORDER 

RPF 

RPH 

LCM ♦ 
LCMB *♦ 



2375+ 
2*»&14- 
2t»634- 

i:0+/LCMA/ 



1.2.4 EXTERNAL SYMBOL LIST 

f external symbol references are declared in the subprogram, a list of the following format follows the 
ist of entry point symbols: 

EXTERNAL SYMBOLS. 



sym. 



sym 



n+1 



sym 



2n+l 



sym 



3n+l 



sym 



7n+l 



sym. 



sym 



n+2 



1-4 
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sym^ sym^ 

Where n Is one-eighth the number of external symbols. If a symbol is a weak external It is 
followed by an asterisk. 

Example. 

FXTFRNfiL SYMBOLS. 

FRHSG CONEXTT Yn»^r»I SYMBOL CCGOTO GPC 
11.3 OCTAL AHB SOUiCE STATiMil«IT lISfl^lG 

The contents of the octal and source statement listing depends on the options selected. 
The list is 130 characters wide with fields assigned as shown in figure 11-1. 



Title Line 


&ibtitle Line 


Error 


Location 


Octal 


Source Lines 


Sequence 


Hags 


Addresses 


Code 





Figure 11-1. Format of Octal and Source Statement Listing 
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Error Flags Error fl^s indicating that errors of the type indicated have been detected on the 

source line or in a subsequent statement that is not listed. These flags are 
described more fully under Error Directory. Lines containing errors are always 
listed. 



Location 
Addresses 



Octal Code 



The! value of the location counter with leading zeros suppressed. If no code is 
generated or no location s3anbol is defined by the statement, this field is blank. 
If at the time the value is assigned, the value of the location counter differs from 
the value of the origin counter, an L precedes the address. 

The actual code generated by this statement. Depending on options selected, the 
listing shows just the first word or all words generated for data generation 
instructions. The field does not include NO instructions (46000g) packed for a 
force upper or zeros packed for a completed parcel on a VFD. A 24-bit PPU 
Instruction is shown two words of data per line. 



If the word contains an address, the octal code is flagged as follows : 

Negative relocatable address 
+ Positive relocatable address 
C Common relocatable address 
X External address 



For a statement that does not generate code, this field is normally blank. 
Exceptions are as follows : 

For a LIT instruction the field contains the address of the first word of 
the literals generated. 

For a COL instruction, the field contains the new beginning-of- comments 
column number. 

For a symbol defined through SET, MAX, MIN, EQU, =, or MICCNT, 
this field contains the octal value of the symbol right justified with leading 
zeros suppressed. 

For an instruction resulting in a change of base, the notation b^^bg is right 
justified in the field, hi indicates the old base and b2 indicates the new base. 

For an instruction resulting in a change of code conversion, the notation 
Cjr~*C2 is right justified in the field, indicates the old code and C2 
indicates the new code. 

For a DUP instruction, the field contains the repeat count. 

For a KIS or BSSZ instruction, the field contains the octal value of the word 
coimt right justified with leading zeros suppressed. If the word count is 
zero the field is blank. 

For a DECMIC or OCTMIC instruction, the field contains the octal value of 
the expression right justified with leading zeros suppressed. 
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Source Code Source statement image (columns 1 through 72) 

Sequence Columns 73 through 90 of the card image or an identifier for an expansion of a 

definition operation as foUows: 



Macro macro name 

Remote code *RMT* 

Duplicated code *DUP* 

Echoed code *ECHO* 

XTEXT file name 

OPDEF Operation field of opdef call, such as SBl 



The recursion level is indicated in the right half of the field. 



COHPftSS 3.71210 - CYBER 70/ COl^PREHENSIVE ASSEHfltER. 

COMMON ANo uriLiry subroutines. 



CS/3£,/7l 16.2S.I.I.. 



5030003516 



Oiijoaoo joo 

612000003'. 



5u71 5'.322 



S<>TZ 37006 



O330005'.7<. 



S'»73 0'»00u05'.66 



5^7^. S1200J3172 



51.75 67771 



5157003516 



5<.76 
51.77 



05700051.75 



ftLC - TABLE MANAGER AND ALtOCATOR. 

ALLOCATOR MTLl. MOVE TABLES TO SCQUI9E ROO-^. ALSO lAY OUfP 
INTERMEOIATE OR CROSS-REFE^ENCrS ONTO SCRATCH FILE. 
ENTRY (AO) = TA3LE IHOEX. 

«Xl) = CHANGE (♦ OR -t TO IA3LE SI7E. 
EXIT (X2) = ORIGIN Of T6 1UE. 

tX3) = NcM LENGTH OF TURLF. 



SA2 
SA5 



S12 
SA? 
SA3 



El 



ORIGI'lSiAO 
SIZES'Al 



NT A9LES 
ORK. I'lS* 
A2H? 
A2»T1 
XI.X3 
X1.-X2 
X3-<6 
Xu .iiLC? 



A3 

ALCX 



MTi/e TASLFS. 



S17 



Si' 

i< J 

S11. 



07-11 
SI^^S. 



VALUil FOR EXIT 



RFTUPN EXIT 

DDC<r(;r IMorx REGISTF- 

CU-'P'NT ORT'-I'I 

ruR-"'!iT L'f;>TH 

NEXT FATLE PRI-.I-I 

HFW ■^T7F 

Tf sr IF RIOM FOR EX.>; 
JU-lf TO Rc-SLLOrATE .' 

iToRf: fi"H "-.iz^: 



SEE tF ENOUGH ROOM 



(11.) = TOTAL Li^'lGTH 



■'AGE 


12 


COMPASS 


le^s 


COM^'AS--, 


1616 


C01 'ASS 


lf.J7 


COM-'ai 5 


16 IS 


COMPASS 




Cii^a^ " 


1 7. C 


COIl'-AiS 




CO-fA'S 


17,2 


c.)- a .s 


t 7 J 


C')'r-.iv ■ 








'•.■'!M- i-r ^ 


1 7 f 


GO-' . 


t • / 


'I'JI- A 




r )"-■«: , 




c : "i A~ - 


1 :■ 1. 


cn" 'A - 




CIH'5' 




C,l-! S 




cax. s- ; 




COM ASS 






1 flh 


r.OM-i(\v ■-. 




'f." 


1 '! n 


CO-^ '1- 




Cm-<"i , ; 








si ~ 




CO" ' l\S' 


I ■ 3 


c I"" a'. ~ 








•"j" A.S 


1.'?'^ 


r.G»' 'ft';- 


I '?7 




1 7 '8 


CC- 'ass 


1 '^9 


-GM'ASC 




i-omas" 


t 7 il 


Gn>>*- 





11.4 LITERALS 

When the D list option has been selected, the assembly listing includes a listing of the literals block 
following the default symbols listing. Following each literal address are the octal contents of the word and 
a display code conversion of the contents of the word. 
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Examples: 



CONTENT OF LITERALS BLOCK. 



oi-^i?! i7ut^577.?7'^>^nnn'^oooon n+.>>y 

01012'=; n5?l?511 ?:'ft50'+'^70nQr) EnUTPFH, 

Oni?6 55??n5?l?5i i?2n5nJ+0n PFOUTP^n 

nni?^ noononooo^nQonooooon 

0101"»1 ?0??17n729{lll5'^5010? oPCGRftM AB 

oiniii 1 7???^♦57^n^a^nnoooo opt. 





CONTENT OF 


LITERALS BLOCK. 




Qn3£« 


1 


7 ^1 e, 


707n 




7?17 


00^7 


G 


T3?T 


onnn 






55ni 


A 


73?^ 


onoQ 




7323 


05^6 


FF 




1 


LI 


73?'"^ 


2i+n=; 


TF 


77?^ 


22ni 


Rft 


7727 




LS 


DEFAULT SY 


MBOLS 





When the D list option is selected, a list of default symbols immediately precedes the literals block. 
Example : 

DEFAULT SYMBOLS DEFINED BY COMPASS 



oooono X 


HSG= 




TflGl 




TflG2 




finr 







11.6 ASSEMBLER STATISTICS 

Assembler statistics are printed at the end of the octal and source statement listing or, if the D list option 
is selected, following the default symbols. Information includes the following: 

• Amount of storage used (octal) 

• Number of source statements 

• Number of symbols defined 

• Number of invented symbols 

• Number of symbol references 

• CPU type in which COMPASS executed and assembly time 

• Number of errors encountered during assembly 

• Number of lost references, that is, references to symbols that have been omitted from the symbolic 
reference table 
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11.7 ERROR DfRiCTORY 



The assembly listing includes an error directoiy if any errors are detected during assembly. The 
directory begins a new page identified with the subtitle ERROR DIRECTORY. Each type of error that 
occurred is called out with a two-line message of the following format: 

X TYPE ERROR description 

OCCURRED ON PAGES p^, p^ , , . . . p^ 

Types and descriptions are given in Tables 11-1 and 11-2. Errors flagged with an alphabetic character 
are fatal. A fatal error causes suppression of binary output. Nonfatal warning flags are numeric; they 
are infoniiative only. 

TABLE 11-1. FATAL ERRORS 



Type 


Message 


Significance 


Action 


A 


ADDRESS FIELD 


An error exists in a variable subfield 


Refer to the 




BAD. 


entry. The following is a list of 


manual for the 






possible errors: 


correct address 








field format 






The CODE character is not A, D, E, I, 


for the opera- 






0, or *. 


tion code 








specified. 






The symbol or name is greater than 8 








characters . 








The expression does not reduce to one 








external term. 








The relocatable terms do not cancel 








properly. 








The instruction requires an absolute 








expression. 








The instruction disallows register 








designators . 








A data error; 8 or 9 is encountered in 








octal data and the modifier is not S, 








P, 0, E, D, or B. 








No data is found in the variable field 








of a LIT instruction. 








No symbol is following an =S, =X, or 








=Y prefix. 








The relative jump is out of range 








(-31>r>31) on a PPU instruction. 








The BASE character is not 0, M, D, 








or *. 
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TABLE 11-1. FATAL ERRORS (Contd) 



Type 


Message 


Significance 


Action 


A 


ADDRESS FIELD 
BAD. (Contd) 


A register is illegal in a CON 
instruction. 

A synonymous instruction for OPSYN or 
CPSYN cannot be located. 

The micro count is less than zero or 
greater than ten. 

The NOLABEL character is not I, 

A negative relocation is specified on 
ORG or ORGC. 

The POS value is less than or 
greater than word size. 

The OPDEF reference is erroneous. 

No comma is following the DIS word 
count. 

An illegal entry is in the variable 
field of IDENT. 




D 


DOUBLY 
DEFINED 
SYMBOL. 
THE FIRST 
DEFINITION 
HOLDS . 


A symbol has been previously defined 
or declared external. 


Rename the 
duplicate 
symbol in the 
program. 


E 


ECHO, DUP, 
RMT, OR 
MACRO 
ILLEGALLY 
NESTED . 


The definition of ECHO, DUP, RMT, or 
MACRO is not entirely within the next 
outer definition. 


Correct the 
program. 


F 


NUMBER OF 

ENTRIES 

EXCEEDS 

PERMISSIBLE 

AMOUNT. 


One of the following error conditions 
exists: 

LIT generates more than 100 words. 

Data is missing or erroneous on XTEXT 
file. 

More than 63 formal parameters and 
local names are in a macro definition. 

There are more than 255 blocks. 

There are more than 511 external 
symbols. 


Correct error 
condition and 
rerun the job. 
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TABLE 11-1. FATAL ERRORS (Contd) 



Type 


Message 


Significance 


Ac" t" i on 


L 


LOCATION 
FIELD BAD. 


The required location field entry is 
erroneous. The format two macro defi- 
nition has no substi tutable parameters. 


Correct the 
location field 
entry . 


N 


NEGATIVE 
RELOCATION ON 
ENTRY POINT. 


An entry point may not be negatively 
relocated . 


Change to use 
positive or 
absolute 
relocation for 
entry points. 
Rerun job. 





OPERATION 
FIELD BAD. 


One of the following error conditions 

pxi'=?f"<=; in t"hp> oriA r Pi i- i r>n f i a 1 ri • 

The instruction is unrecognizable. 
The instruction is out of sequence, 

11 ch a <=! A R'^ or PPIT nof- in i-ho firct- 

O UV-'H do r\.LJiJ <JL. £r XT KJ iiwU in U liO 1. X X. o w 

statement group. 

The instruction is illegal for binary 
mode. 

The relational mn(=>iinr>n i r* nn hhp> TP 

statement is erroneous. 


Correct the 
field. 


P 


CONSULT 
LISTING FOR 
REASON BEHIND 
P- ERROR 


A user-generated error flag from an 
ERR or ERRxx instruction has been 
encountered . 


Action to be 
taken depends 
upon source of 
error . 


R 


DATA ORIGIN 
OUTSIDE BLOCK 
OR IN BLANK 
COMMON . 


An attempt was made to set data into 
blank common or beyond block limits. 


Use labeled 
common or 
increase blocK 
size and rerun 
job. 


U 


UNDEFINED 
SYMBOL . 
VALUE 
ASSUMED 0. 


There is a reference to a symbol that 
is not defined; for example, an IF 
statement line count, a DIS word 
count, an unrecognizable attribute on 
an IF statement, or an undefined 
qualifier. 


Define tne 
symbol . 


V 


BIT COUNT 
ERROR ON VPD 
(MUST BE 
0<COUNT<60) . 


The VFD field size is erroneous. 


Correct the 
size of the VFD 
field. 
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TABLE 11-2. INFORMATIVE ERRORS 



Type 


Message 


Significance 


Action 


1 


LOCATION SYMBOL 
BAD. 

SYMBOL NOT 
DEFINED. 


The location field entry is erroneous. The instruc- 
tion does not require an entry. 


Define or 
eliminate the 
symbol in the 
location field. 


2 


ADDRESS ERROR 
ON SYMBOL 
DEFINITION. 


The variable field entry is erroneous. The location 
field symbol is not defined. 


Correct the 

symbol 

definition. 


3 


DUPLICATE MACRO 
DEFINITION. NEW 
ONE OVERRIDES. 


The macro, opdef, or synonymous operation 
redefines the operation code. 


Rename the 
duplicate 
macro name. 


4 


BAD FORMAL 
PARAMETER NAME 
IGNORED. 


The macro or ECHO formal parameter name is 
repeated or illegal. 


Correct the 
formal 
parameter 
name. 


5 


CPU OPERATION 
SYNTAX INCOR- 
RECTLY SPECIFIED. 


The OPDEF, CPOP, CPSYN, or PURGDEF specifies 
an illegal syntax. 


Correct the 
syntax of the 
pseudo 
instruction. 


6 


LOCATION FIELD 
MEANINGLESS. 


The entry in the location field is erroneous; it is 
ignored. 


Correct the 

location 

field. 


7 


ADDRESS VALUE 
EXCEEDS FIELD 
SIZE, RESULT 
TRUNCATED. 


The value of the address is erroneous; one of the 
following conditions exists: 

The value of the expression exceeds the size of the 
destination field. 

The BSS address expression value is negative. 

The MICRO starting character position or charac- 
ter count is negative. 


Check the 
possible 
values of the 
variable 
subfield. 


8 


MISSING OR EXTRA 
ADDRESS SUBFIELD. 


The variable subfield entry is missing or superfluous. 


Correct the 

variable 

subfield. 


9 


MICRO SUBSTITU- 
TION ERROR. NO 
SUBSTITUTION. 


The micro reference is unrecognizable. 


Correct the 

micro 

reference. 



11.8 SYMBOLIC REFERENCE TABLE 

The assembler generates a symbolic reference table (figure 11-2) if the L list option is on at the end of 
assembly. The table is not complete if the option was turned off at any time during the assembly. The 
tables lists symbols according to the qualifier, if any, under which they were defined. The global symbols 
are listed first. A new heading of the following form introduces each new list of qualified symbols. 

SYMBOL QUALIFIER = qualifier 
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The qualifiers are in the order declared in the subprogram. Symbols are listed alphabetically. 



When symbol references are lost because table space has been exceeded, the subtitle line includes 
notification in the form n LOST REFERENCES. 

Format 1 reflects the XREF P effect; P is the default for the XREF pseudo instruction. Formats 2 and 3 
reflect the effects of XREF B and XREF A, respectively. 



Title Line 




SYMBOLIC REFERENCE TABLE. // 




Format 1 ( 
symbol 


XREF P): 
value 


block 


page/line 


ho 

CO 

r—t 

Cm 


page/line 


«t-i 


page/line 


bsj 
«»-( 


\\page/line 




page/line 






Format 2 ( 
symbol 


XREF B): 
value 


block 


page/line 


hD 


address, 


page/line 


fao 


^ j address, 


page/line 


be 



Format 3 (XREF A): 
















symbol 


value 


block 


address, 


address, 


address, 


1 


address, 

/ 


address, 



Figure 11-2. Format of Symbolic Reference Table 



symbol 
value 



Alphabetical list of symbols defined under the qualifier. 

Absolute value of the sjnnbol or the address assigned to this symbol relative to 
the block named. 



block 



page/line 



address 



If the symbol was defined by the SST pseudo instruction, block is the system 
text file or overlay name. Otherwise, this field is blank in an absolute assembly 
or, in a relocatable assembly, it contains the name of the block containing the 
symbol. 

From left to right and from top to bottom, a list of indices sequenced according 
to page number. Each index points to a statement containing references to the 
symbol or defining the symbol. Present when XREF B or P is hi effect. 

The location counter address of the instruction containing the reference. Pres- 
ent when XREF A or B is in effect. 
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flag 



Identifies page/line index to a statenaent that defines the symbol or uses it in an 
IF statement as follows: 



D Definition statement; EQU, =, SET, MAX, MIN, or MICCNT 

E ENTRY or ENTRYC pseudo instruction 

F Symbol used in conditional test 

I Symbol used for indirect storage (applies only to PPU or PERIPH 
assemblies) 

L Symbol used in location field of the statement 

S Symbol used for storage 



X EXT pseudo instruction 
?^en XREF A is in effect, the table does not include the flags. 
Example: 



COMPASS 3.71210 - CY8ER 70/ COMPREHENSIVE ASSEMBLER. 
SYMaOLlC REFERENCE lABtE. 



COHPtSS 3.7l2lj 
0E8OG 



SNTEMP 

SfiUHS 

SNUHBl 

SNMLIN 

SNHLINt 

SNWLINZ 

SNX 



AF 

CCS 

CCSl 

CCS2 

CSA 

CSC 

CSH 

CSL 

CSR 

CSZ 

DCS 

OCSl 



ES 

ESC 

EV 

FC 

F« 

GCS 

SCSI 

GCS2 

GCS3 

CCS<> 

GCS5 

GCS& 

GCS 7 

GCSS 

INT 

LRS 

NCS 



5115 

5<tl6 
^1,23 
5'.25 

51311 



6675 
7326 
7332 
7323 
725". 
7257 
7250 
7263 
7266 
7261 
7222 
7225 
667ii 
6673 
6653 

6{:>6i 

6715 



6662 
71*1 
6663 
6660 
6676 
727a 
7275 
7277 
730u 
7303 
730". 
7306 
7337 
7316 
7135 
67<«a 
?233 



72/12 

73/'.a 

78/'.8 
73/28 
79/11. 
79/13 
72/16 



71./51 
7i./u3 
78/53 
73/I.1 
79/16 
79/17 
72/39 



72/32 S 72/1.2 S 



70/53 
71./12 
78/56 
7i./i;5 



7<./ia 

7<./16 



76/2. J 
71./: 3 



76/2'» 
7'./i.2 



.8/2U/71 16.25.4<>. 



75/1.'. 75/50 
79/C8 L 70/1.1 



SYMBOL QUALIFIER = DATA 



115/39 


L 


115/1.5 




121/37 




131/52 


i32/19 


132/32 




132/11* 




133/u3 




133/18 




113/31 


133/1. i. 


131./: 2 


135/1.8 


135/52 




I3.i/5l. 


L 














133/3R 


L 


13»^/C•l 
















117/32 




121'20 




133/Cl 


L 










117/26 




121/17 




io:/i6 


L 










117/20 




121/11. 




122/1.2 


L 










117/17 




121/11 




iri/i..' 


L 










117/H 




121/08 




1 Si/5 7 


L 










117/. 8 




121/U5 




133/29 


L 










117/. 9 




117/12 




117/18 




117/21 


117/27 


117/32 


131/33 


131/1.2 


L 


131/1.6 
















115/38 


L 


l2'-/35 




131./2 J 












115/37 


L 


115/1.6 


S 


116/35 




126/35 


131./19 






115/16 


L 


l?w/25 




122/*1 




}2"/j5 


121./27 


I 32 /If 




115/21 


L 


t2J/2l 




125/1 S 




126/33 


127/C5 <; 






116/3: 


I 


171/35 




122/01. 






125/.i6 


xzri-.i 


131/51 


116/53 




121/51 




l?2/j7 




125/38 


i25/H 


1?8/19 


132/. 8 


118/57 




122/^1 




t22/lw 




125/5» 


126/1. K 


i?8/m 


132/11 


115/22 


I 


















122/22 




128/01. 


L 














115/23 


L 


122/1.3 




123/C7 


S 


123/1.2 








115/19 


L 


12:/35 


S 


12:/*9 












115/1.0 


L 


135/U3 




135/17 












132/1.9 




13^/08 




133/21 




133/71. 


132/1.7 


13i./^6 


1311/19 


13*/3* 


L 


131./37 
















13I./32 




131./39 


L 














13'./i.l 


L 


















13I./1.U 




131./1.5 


L 














131./I.8 


L 


131./51 
















l?i»/i.6 




i3'./53 


L 














ni./»3 




131./55 


L 














135/1,2 




135/11 




135/15 


L 










125/«.8 




126/55 


L 














117/15 




117/21. 




tl7/3C 




119/06 L 








121/06 




121/09 
>1J2/Z^ 




.121/12 




121/15 


121/18 


121/21 


132/05 
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COMMON COMMON DECKS 



12 



The common common decks are a set of COMPASS subroutines which are powerful tools for use by 
COMPASS programmers. The common common decks perform functions such as: 

Data conversion 

Dynamic table management 

Saving/restoring registers 

Providing an input/output interface at the CIO and FET level 

All of the common common decks run under NOS and NOS/BE; a subset of them run under SCOPE 2. 
Table 12-1 shows each deck name, relocatable program name, entrj^ point names, and the decks 
supported under SCOPE 2. 

12.1 RESIDENCE OF THE COMIJON COfkWO^ DECKS 

The source of the common common decks resides on the COMPASS old program library as a set of 
COMDECKs. This old program library can be used by Update-based procedures as a secondary old 
program library (see the Update Reference Manual); the decks can be called just as one would call a 
common deck from one's own old program library. Modify -based products can convert the COMPASS 
old program library to an OPL via the UPMOD utility (see the Modify Reference Manual); the OPL is 
then used as the source for the common common decks. The source of the common common decks can 
also be obtained via the use of the COMPASS XTEXT pseudo-instruction using either an old program 
library or an OPL as input. System texts required to assemble the common common decks residing 
on the COMPASS old program library are IPTEXT and CPUTEXT. 

The common common decks (except the table management decks COMCMTM and COMCMTP) are also 
available as relocatable subroutines which reside on the system library SYSLIB. Relocatable programs 
need only include external references to entry point names in the common common decks. These 
external references are satisfied from SYSLIB at load time. (The CYBER Loader searches SYSLIB by 
defeult when satisfying external references but the SCOPE 2 Loader does not. Hence, under SCOPE 2, 
SYSLIB must be explicitly included in the library set.) 

12.2 DESCRIPTION OF THE COMMOI^ COyyOf^ DECKS 

A detailed external reference description of each common common deck follows. The decks are 
described in alphabetical order. Each description lists entry and exit conditions, registers used, and 
routines explicitly called. 

The following rules apply to the use of all common common decks: 

Any input/output buffers, string buffers, exchange package save areas, and so forth, to be used by 
any of the common common decks should not be located with the last lOB words of the field length. 
Some fetch loops, move loops, and so forth, may mode out if the above restriction is not adhered to. 

Registers that are not used by the common common decks are not modified. 

Entry and exit conditions are only those listed in the descriptions below. 
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TABLE 12-1. SUMMARY OF COMMON COMMON DECKS 



Deck Name 


Program Name 


Entry Points 


A ?7cs ilol^l*^ \^x\c\f^'t* 

SCOPE 2 


COMCARG 


CPU. ARC 


ARG= 


Yes 


COMCCDD 


CPU. CDD 


CDD= 


Yes 


COMCCFD 


CPU. CFD 


CFD= 


Yes 


COMCCIO 


CPU. CIO 


CIO= 


No 


COMCCOD 


CPU. COD 


COD= 


Yes 


COMCCPT 


CPU. CPT 


CPT= 


Yes 


COMCDXB 


CPU.DXB 


DXB= 


Yes 


COMCMNS 


CPU.MNS 


MNS= 


Yes 


COMCMOS 


CPU.MOS 


MOS= 


Yes 


COMCMTM 






Yes 


COMCMTP 






Yes 


COMCMVE 


CPU.MVE 


MVE= 


Yes 


COMCRDC 


CPU.RDC 


RDC= 


No 


COMCRDH 


CPU.RDH 


RDH= 


No 


COMCRDO 


CPU.RDO 


RDO= 


No 


COMCRDS 


CPU.RDS 


RDS= 


No 


L'VJiViC'KiJvV 


y^sr U . KJJW 


RDW= 
KDA- 

LCB= 


No 


COMCRSR 


CPU.RSR 


RSR= 


Yes 


COMCSFN 


CPU.SFN 


SFN= 


Yes 


COMCSRT 


CPU.SRT 


SRT= 


Yes 


COMCSST 


CPU.SST 


SST= 


Yes 


COMCSTF 


CPU.STF 


STF= 


No 


COMCSVR 


CPU.SVR 


SVR = 


Yes 


COMCSYS 


CPU. SYS 


SYS= 
RCL= 
W JNxj- 
MSG= 


No 


COMCUPC 


CPU. UPC 


UPC= 


Yes 


COMCWOD 


CPU.WOD 


WOD= 


Yes 


COMCWTC 


CPU.WTC 


WTC= 


No 


L/UMC W 1 H 


Cl^U .Win 


TTTrp XT 

W 1 H- 


No 


COMCWTO 


CPU. WTO 


WTO= 


No 


COMCWTS 


CPU.WTS 


WTS= 


No 


COMCWTW 


CPU.WTW 


WTW= 
WTX= 
DCB= 


No 


COMCXJR 


CPU.XJR 


XJR= 


No 


COMCZTB 


CPU. ZTB 


ZTB= 


Yes 
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12.2.1 COMCARG - PROCESS ARGUMENTS 

COMCARG processes a list of arguments by the use of an equivalence table. The argument list must 
be in the following format: 

12/op, 18/asv, 12/st, 18/addr 

op One or two character keywords (left justified, zero filled) 

asv Address of assumed value 
st Status 

addr Address where argument is placed 

This format is generated by COMCUPC or the COMPASS VFD pseudo instruction. ARG= is the only 
entry point for COMCARG. 

Entry conditions: 

(Bl) 1 

(B4) Argument count 

(A4) Address of first argument 

PC4) First argument 

(B5) Address of argument table 

Exit conditions: 

(XI) 

1 Option not found in table 

2 Single argument equivalenced 

3 Illegal re-entry of argument 

Registers used: 

A2, A3, A4, A7 
B2, B3, B4 

XO, XI, X2, X3, X4, X6, X7 

The following conditions apply to the use of COMCARG: 

If a keyword=vaiue form is found in the argument list, addr is set to the upper 42 bits of the argu- 
ment value (in bits 59-18) and the lower 18 bits of asv (in bits 17-0). 

If only a keyword is found in the argument list, addr is set to the full 60 bits of asv. 

If asv < 0, the argument cannot be equivalenced. 

If status=4000B, a zero value is retained as a display zero. Otherwise, a value of zero (full word) 
is stored at addr. 

If asv=addr, only one entry of that argument is allowed aad op is set to -0. 



12.2.2 COMCCDD - CONSTANT TO DECIMAL DISPLAY CODE CONVERSION 

COMCCDD converts an integer constant to decimal display code. Up to ten digits are converted with 
leading zero suppression. The converted integer contains space fill. One register contains the display 
code right justified; another register contains it left justified. CDD= is the only entry point for 
COMCCDD. 
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Entry conditions: 
(Bl) 1 

(XI) Number to be converted 
Exit conditions: 

(B2) 6* (count of digits converted) 
(X4) Conversion left justified 
(X6) Conversion right justified 

Registers used: 

A2, A3, A4 
B2, B3, B4 

XI, X2, X3, X4, X6, X7 



12.2.3 COMCCFD - CONVERT CONSTANT TO F10.3 FORMAT 

COMCCFD converts a 30 bit integer to display code in FORTRAN FIO. 3 format. The integer 
represents the floating point value time 1000. One register contains the display code right justified 
with blank fill; another register contains it left justified with blank fill. Leading zeros in the integer 
portion are suppressed. CFD= is the only entry point for COMCCFD. 

Entry conditions: 



Exit conditions: 

(B3) -(number of blank fill bits in result) 
(X4) Conversion left justified 
(X6) Conversion right justified 

Registers used: 

Al, A2, A3, A4 
B2, B3, B4, B5 
XI, X2, X3, X4, X6, X7 

12.2.4 COMCCIO - I/O OPERATION PROCESSOR 

COMCCIO performs input/output operations via the peripheral processor program CIO. An operation 
is performed when the buffer is not busy. If the file-status-word is zero, the operation is not proces- 
sed and IN and OUT are set to FIRST. CIO= is the only entry point for COMCCIO. 

Entry conditions: 

(X2) 24/unused, 18/skip count to CIO, 18/FET address for file 

(X7) Function code; if < 0, X7 is the complement of the request and auto recall is requested 
Exit conditions: 



(Bl) 
(XI) 



Integer to be converted 



1 



(X2) 
PC7) 



FET address 
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If ERP$ is defined: 

(X2) FET address 
(X7) FET error code: 

No error, operation performed, normal exit 

other Error code from FET; operation not performed, exit to ERP$ 

If ERP1$ is defined: 

(X2) FET address 
(X7) FET error code: 

No error, operation performed, normal exit 

other Error code from FET; operation not performed, normal exit 

Registers used: 

Al, A6, A7 
XI, X2. X6, X7 



12.2.5 COMCCOD - CONVERT CONSTANT TO OCTAL DISPLAY CODE 

COMCCOD converts an integer constant to octal display code with leading zero suppression. Up to ten 
digits can be converted. The converted integer contains space fill. One register contains the display 
code right justified, another register contains it left justified. COD= is the only entry point for 

Entry conditions: 
(Bl) 1 

(XI) Number to be converted 
Exit conditions: 

(B2) 6* (count of digits converted) 
(X4) Conversion left justified 
(X6) Conversion right justified 

Registers used: 

A4 

B2, B3, B4 

XI, X2, X3, X4, X6, X7 

12.2.6 COMCCPT - EXTRACT COMMENTS FIELD FROM PREFIX TABLE 

COMCCPT copies the comments field of a prefix (7700g) table to a working storage area. Either the old 
or new forms of the prefix table can be used. COMCCPT differentiates between the forms by checking 
word FWA+3 of the table to see if it looks like a time-of-day word. The copy terminates on end-of-table, 
zero byte, or COPYRIGHT. The working storage area is terminated by a zero word. CPT= is the only 
entry point for COMCCPT. ^ 

Entry conditions: 

(Al) Prefix table address 

(A6) Address of wwking storage - I 
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(Bl) 1 

(XI) Control word 



Registers used: 

A2, A3, A4, A6 
B3, B4 

XI, X2, X3, X4, X6 



12.2.7 COMCDXB - CONVERT DISPLAY CODE TO BINARY 

qO.MCDXB converts one word of display code digits into internal integer format. Either a base 10 or a 
base 8 string of digits can be converted as specified in the call. This specification, however, is over- 
ridden if an explicit B (octal) or D (decimal) is the last character of the value to be converted. DXB = 
is the only entry point for COIMCDXB. 

The assembly option DXB1$ controls the processing of an 8 or 9 when octal is specified for the display 
code value and no explicit B or D appears in the value. If DXB1$ is not defined, an error occurs. If 
DXB1$ is defined, the value is considered to be decimal. 



Entry conditions: 
(Bl) 1 

(B7) Base; if > 0, decimal base; if 0, octal base. 
(X5) Word to be converted (left justified, zero filled) 

Exit conditions: 

(X6) Converted digits 
(X-4) Error code: 



Eegisters used: 
B2, B3, B4, B5 

XO, XI, X2, X3, X4, X5, X6, X7 

The presence of one or more of the following always causes an error: 

• A non-digit in the word to be converted 

• A character after the post radix 

• An 8 or 9 with the post radix equal to B 

12.2.8 COMCMNS - MOVE NON-OVERLAPPING BIT STRING 

COI\IC:\INS moves a specified source string from one location to another in central memory. The o 
bits disturbed in the destination field are those extracted to accept the source string. The destinati 
field must not overlap the soLurce field in any way; results are undefined if overlapping occurs; 
COMCMOS can be used for overlapping moves ]\INS= is the only entry point for COMCMNS. 

Entry conditions: 



No error 

other Error in assembly 



(Bl) 
(B2) 
(B4) 



1 

Source first bit (0, 1, ... , 59) 
Destination first bit (0, 1, . . . , 59) 
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(XO) Number of bits to move 
PC2) Source first word address 
(X4) Destination first word address 

Exit conditions: 



(Bl) 1 

(B2) Source next bit (0, 1, ... , 59) 

(B4) Destination next bit (0, 1, ... , 59) 

(X2) Source next word address 

(X4) Destination next word address 



Registers used: 

Al, A2, A3, A5, A6 

Bl, B2, B3, B4, B5, B6 

XO, XI, X2, X3, X4, X5, X6, X7 



12.2.9 COMCMOS - MOVE OVERLAPPING BIT STRING 

COMCMOS moves a specified source string from one location to another in central memory. The only 
bits disturbed in the destination field are those extracted to accept the source string. GOMCMOS 
allows the user to move strings where the destination field overlaps (lies partly or completely within) 
the source field. If the move is not an overlap move, COMCMOS calls the faster common common 
deck COMCMNS to do the move. For this reason, COMCMNS should always be called whenever 
COMCMOS is. MOS= is the only entry point for COMCMOS. 

Entry conditions: 

1 

Source first bit (0, 1, ... , 59) 
Destination first bit (0, 1, ... , 59) 
Number of bits to move 
Source first word address 
Destination first word address 



(Bl) 
(B2) 
(B4) 
(XO) 
(X2) 
(X4) 



Exit conditions: 
(Bl) 1 

{B2) Source next bit (0, 1, .... 59) 
(B4) Destination next bit (0, 1, . . . , 59) 
(X2) Source next word address 
(X4) Destination next word address 



Registers used: 



Al, A2, A3, A5, A6, A7 
Bl, B2, B3, B4, B5, B6 
XO, XI, X2, X3, X4, X5, X6, X7 

Calls: 



MNS= 



60492600 E 



12-7 



12.2.10 COMCMTM - MANAGED TABLE MACROS 

COMCMTM contains four macros, ADDWED, ALLOC, SEARCH, and TABLE, for generation, alloca- 
tion, and processing of managed tables. COMCMTM is intended to be used with COMCMTP. 

ADDWRD - ADD WORD TO TABLE 

ADDWRD adds a word to a managed table. ADDWRD calls ADW and uses AO and XI. 
Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




ADDWRD 


table, reg 



table Table number 

reg Register name or expression for word to be added 

ALLOC - ALLOCATE TABLE SPACE 

ALLOC allocates table space. ALLOC calls ATS and uses AO and XI. 
Format: 



lOCATION 


OPERATION 


VARIABIE SUBFIEIDS 




ALLOC 


table, words 



table Table number 

words Word count (+ or -) to be added 

SEARCH - SEARCH MANAGED TABLE 

SEARCH searches for a specified entry. SEARCH calls EQS or MES and uses AO, B7, and X6. 
Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




SEARCH 


tname, entry, mask 



tname Table name 

entry Entry to be searched for 

mask Search mask in XO; if not present, defaults to all bits. 



TABLE - GENERATE MANAGED TABLE 
TABLE generates a managed table. 
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Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




TABLE 


tname, count, equiv 



tname Table name 

count Word count per entry (1 if not specified) 

equiv Equivalent table name; allows certain tables to be used by different processors 

After the table is generated: 

F. tname is the name of the word containing the table FWA. 
L. tname is the name of the word containing the table length, 
C. tname is the word count per entry, 

12.2.11 COMCMTP - MANAGED TABLE PROCESSORS 

COMCMTP contains the following routines for processing managed tables: 



ADW 


Adds a word to the table. 


AMU 


Returns the total memory used by the tables. 


ATS 


Allocates table space. 


EQS 


Searches table for equal entries. 


MES 


Searches a table for equal entries using a mask. 


MTD 


Moves the table down. 


MTU 


Moves the table up. 



Macros for calling these routines and for table generation are contained in COMCMTM. 

The managed table processors allow the partitioning of central memory into variable regions called 
tables. These tables are referenced by pointers that indicate the first word address of the table and 
the table length. Memory is allocated to each table as it is required; the user can delete space from 
the tables. Each table is allowed at least one word of expansion space to allow a dummy word between 
each table, thus, ensuring efficient search methods. 

The caller of the table processors is expected to provide certain constants for use by the processors. 
Other data is provided by COMCMTM. 



Data provided by the caller: 

MEML Lowest address of managed memory 

TOV Address of the table overflow processor 

Data provided by COMCMTM: 

NTAB Number of managed tables 

FTAB Start of table addresses 

LTAB Start of table lengths 

F.tnam Address pointer for table tnam 
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L.tnam 



Length pointer for table tnam 



Data dynamically changeable: 

TN Number of managed tables. Set to NTAB by COMCMTM. TN must be less than NTAB 

during use. 

TO Table overflow processor. Set to TOV by COMCMTM. 

LM Low memory limit. Set to ME ML by COMCMTM. If this value is increased, MTU 

should be called to allow room for change. 

F.TEND High memory limit. F.TEND must be initialized by the user. If this value is 
decreased, MTD should be called to allow room for change. 

TOVT TOV threshold. If the word is defined, it should contain the threshold for calling 

TOV; ATS calls TOV when the tables must be moved and less than TOVT free words 
remain. If TOVT is not defined, an effective value of zero is used. 



ADW - ADD WORD TO TABLE 

ADW adds a word to a managed table. 

Entry conditions: 

(AO) Table number 
(XI) Word to be added 

Exit conditions: 

(A 6) Address of added word 

(XI) Added word 

(X2) FWA of table 

(X3) Length of table 

(X6) Added word 

Registers used: 

Al, A2, A3, A4, A6, A7 
XI, X2, X3, X4, X6, X7 

Calls: 

ATS 



AMU - ACCUMULATE MEMORY USED 

AMU returns the amount of memory used by the managed tables or the current length, whichever is the 
largest. The variable MU is set to this value. 

Exit conditions: 

MU MAX(memory used, current assigned length) 
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Registers used: 

Al, A2, A6 

B2 

XI, X2, X3, X6 
ATS - ALLOCATE TABLE SPACE 

ATS allocates table space. The table length can be incrsased or decreased as specified. 

Entry conditions: 

(AO) Table number 

(XI) Change (+ or -) to the table size 

Exit conditions: 

(XI) Change made to the table size 

(X2) FWA of table 

(X3) New length of table 

(X7) Less than if tables moved 

Registers used if tables are not moved. 

A2, A3, A4, A6 
X2, X3, X4, X6, X7 

Registers used if tables are moved: 

Al, A2, A3, A4, A6, A7 
B2, B3, B4, B5, B6, B7 
XO, XI, X2, X3, X4, X5, X6, X7 

Registers restored: 

B2, B3, B4, B5, B6, B7 (except -0 restored as -H)) 
XO, XI, X5 

Calls: 

AMU, MVE=, TOV 

TOV, the user provided table overflow processor, is described below. 

Entry conditions: 



The location TOV must contain executable code. TOV is entered via a JP instruction. 
Exit from TOV via a JP B6 instruction. 
Exit conditions: 

Only Bl must be preserved. 

A pointer word must be incremented by the number of words newly available. If TN has not been 
altered during execution, the address of the pointer word is F. TEND. If TN has changed, the 
address of the pointer word is FTAB-1 plus the contents of TN. 
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(Bl) 
(B5) 
(B6) 



1 



Complement of number of words required 
Return address to continue processing 



EQS " EQUALITY SEARCH TABLE 

EQS searches for a specified entry. 

Entry conditions: 

(AO) Table number 

(B7) Word count per entry 

(X6) Entry for search 

Exit conditions: 

(X2) = if entry not found 

{X2) = entry, if found 

(A 2) = address of entry found 

Registers used: 

Al, A2, A6 
XI, X2, X3, X7 

MES - MASKED EQUALITY SEARCH TABLE 

MES searches for a specified entry using a mask. 

Entry conditions: 

(AO) Table number 

(B7) Word count per entry 

(XO) Mask 

PC6) Entry for search 

Exit conditions: 

(X2) = if entry not found 

(X2) = entry, if found 

(A 2) = address of entry found 

Registers used: 

Al, A2, A6 

XI, X2, X3, X4, X7 

MTD - MOVE TABLES DOWN 

MTD moves the tables down (away from RA) to eliminate unused memory. 
Exit conditions: 

(B2) Number of tables 

Registers used: 

Al, A2, A3, A7 
B2, B3 

XO, XI, X2, X3, X4, X7 
Calls: 

MVE= 



12-12 



60492600 F 



MTU - MOVE TABLES UP 

MTU moves the tables up (toward RA) to eliminate unused memory. 
Registers used: 

Al, A2, A7 

B3 

XO, XI, X2, X3, X7 
Calls: 

MVE = 



12.2.12 COMCMVE - MOVE BLOCK OF DATA 

COMCMVE moves a block of data to a specified location. COMCMVE moves the data from the source 
address through the source address plus the word count minus one to the destination address through 
the destination address plus the word count minus one. The move can be in either direction. MVE = 
is the only entry point for COMCMVE . 

Entry conditions: 

(Bl) 1 

(XI) Word count 
(X2) Source address 
(X3) Destination address 

Registers used: 

A2, A4, A6, A7 
B7 

XI, X2, X3, X4, X6, X7 



12.2.13 COMCRDC - READ CODED LINE, C FORMAT 

COMCRDC reads a coded line terminated by a zero byte from a CIO buffer to a working buffer. RDC= 
is the only entry point for COMCRDC. 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 is less than zero, then -B7 is the word count of the working buffer; COMCRDC will not read 
and discard words until an end-of-line for lines longer than the working buffer. 

Exit conditions: 
(Bl) 1 

(B6) Address of last word transferred to working buffer plus one 
(XI) Status of transfer: 

Transfer completed 

-1 EOF detected on file 

-2 EOI detected on file 

B6 EOR detected _on file before transfer completed 
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(X2) Address of FET for file 

(X4) Contents of last data word transferred before EOL guaranteed 
(X7) Level number of EOR 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 

LCB=, EDX= 



12.2.14 COMCRDH - READ CODED LINE, H FORMAT 

COMCRDH reads a coded line terminated by a zero byte from a CIO buffer to a working buffer with 
trailing space fill. RDH= is the only entry point for COMCRDH. 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

Exit conditions: 

(Bl) 1 

(B6) Address of last word transferred to working buffer plus one 
(XI) Status of transfer: 

Transfer completed 

-1 EOF detected on file 

-2 EOI detected on file 

B6 EOR detected on file before transfer completed 
(X2) Address of FET for file 
(X7) Level number of EOR 

Registers used: 

Al, A2, A3, A4, A6 

Bl, B2, B3, B4, B5, B6, B7 

XI, X2, X3, X4, X6, X7 

Calls: 

LCB=, RDX= 

12.2.15 COMCRDO - READ ONE WORD 

COMCRDO reads one word from a CIO buffer into X6. RDO= is the only entry point for COMCRDO. 
Entry conditions: 

(Al) Address of IN pointer 
(Xl) IN 
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Exit conditions: 



(Bl) 1 

(XI) Status of transfer: 

Transfer completed 

1 EOR detected on file 
-1 EOF detected on file 
-2 EOI detected on file 

(X2) Address of FET for file 
(X6) Word read 



Registers used: 

Al, A2, A3, A4, A6. A7 
Bl 

XI, X2, X3, X4, X6, X7 
Calls: 
C10= 



12.2.16 COMCRDS - READ CODED LINE TO STRING BUFFER 

COMCRDS reads a coded line from a CIO buffer to a working buffer. Words in the circular buffer are 
unpacked and stored one character per word in the working buffer. This process is continued until 
the end-of-line byte is detected. If the coded line terminates before the working buffer is filled, the 
working buffer is padded with spaces; the buffer is not padded if the complement of the word count of 
the buffer is used. If the coded line exceeds the size of the working buffer, the excess characters are 
ignored. RDS= is the only entry point for COMCRDS. 



Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 is less than 0, B7 is the complement of the buffer length and the string buffer will not be 
space filled. 



Exit conditions: 



(B6) Address of the last character from the coded line in the working buffer plus one 
(XI) Status of transfer: 

Transfer completed 

-1 EOF detected on file 

-2 EOI detected on file 

B6 EOR detected on file before transfer completed 
(X2) Address of FET for file 
(X7) Level number of EOR 



Registers used: 

Al, A2, A3, A4, A6, A7 

Bl, B2, B3, B4, B5, B6, B7 

XI, X2, X3, X4, X6, X7 
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Calls: 



LCB=, RDX= 

12.2.17 COMCRDW - READ WORDS TO WORKING BUFFER 

COMCRDW reads a specified number of words from a CIO buffer to a working buffer. COMCRDW also 
contains the load CIO buffer and read exit routines required by COPvICRDC, COMCRDH, and COMCRDS. 
RDW=, LCB=, and RDX=- are the entry points for COMCRDW. 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

Exit conditions: 



(Bl) 


1 




(B6) 


Address of last word transferred to the working buffer plus one 


(B7) 


Word count remaining to be transferred 


(XI) 


Status of transfer: 





Transfer completed 




-1 


EOF detected on file 




-2 


EOI detected on file 




-3 


CIO= was called to read more data and returned an error status 




B6 


EOR was detected on file before transfer was completed 



(X2) Address of FET for file 

(X7) Error status if XI is -3, otherwise level number of EOR 

Registers used: 

Al, A2, A3, A4, A6, AT 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 

CIO= 



12.2.18 COMCRSR - RESTORE ALL REGISTERS 

COMCRSR restores the B, A, and X registers from a specified register save area. The format of the 
registers in the save area is BO, Bl, . , . , B7, AO, Al, . . . , A7, XO, XI, . . . , X7. Each regis- 
ter occupies a full word with the B and A register values in bits 17-0. RSR= is the only entry point for 
COMCRSR. 

Entry conditions: 

(XI) Address of register save area 
Exit conditions: 

All registers are set to the content of the register save area. 
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Beglsters used: 



AO. Al, A2, A3, A4, AS, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XO, XI, X2, X3, X4. K5. X6, X7 



12.2.19 COMCSFN - SPACE FILL NAME 

COMCSFN coaverts trailing 00 characters In a word to blanks, SFN= Is the only entry point for 
COMCSFN. 

Entry conditions: 

(XI) Name left justified, zero fill 
(Bl) 1 

Exit conditions: 

(X6) Name space filled 
(X7) Final character mask 

Registers used: 

A3 
B2 

X3, X6, X7 



12.2.20 COMCSRT - SET RECORD TYPE 

COMCSRT identifies the format of a record from the first 64 words located in a working buffer. The 
type codes returned are listed in table 12-2. L.SRT is defined to be the largest number assigned a 
record type code. SRT= is the only entry point for COMSCRT. 

Entry conditions: 
(Bl) 1 

(XI) LWA+1 of block 

(X2) FWA of current record 

Exit conditions: 

(X6) 42/OL rename, 12/0, 6 /type number 
(X7) Record name in L format 

If type number and record name are zero, the record is zero length. 
Registers used: 

Al, A2, A3 
B2 , B3 

XO, XI, X2, X3, X4, X6, X7 

12.2.21 COMCSST - SHELL SORT TABLE 

COMCSST sorts a table of one word entries into ascending order using a shell sort. All of the entries 
should be of the same sign. SST= is the only entry point for COMCSST. 



60492600 F 



12-17 





TABLE 12-2. 


TYPE CODES RETURNED BY COMCSRT 


Type 


Number 




TEXT 





Text record 


6PP 


1 


6000-series peripheral processor overlay 


COS 


2 


Chippewa OS formatted program 


REL 


3 


Relocatable subprogram 


OVL 


4 


Central processor overlay 


ULIB 


5 


NOS user library 


OPL 


6 


Modify program library deck 


OPLC 


7 


-LVlOtl IXy tig X dill llkJ± cLx y K/\JLlllli\Jtl KXxJX^n. 


OPLD 


8 


Modify program library directory 


ABS 


9 


Multiple entry point overlay 


7PP 


10 


7000-series peripheral processor overlay 


UPL 


11 


TTndate seaiiential xyrnorFam libraru 


UCF 


12 


Update compressed compile file 


ACF 


13 


Modify compressed compile file 


CAP 


14 


Fast dynamic load capsule 


DATA 


15 


Arbitrary data 




16 


CDC reserved 


PROC 


17 


Procedure record 


SDR 


18 


Special deadstart record 



Entry conditions: 
(Bl) 1 

(B7) Address of table to be sorted 
pel) Number of elements in the table 

Exit conditions: 

The table is sorted. 

Registers used: 

Al, A2, A6, A7 
B2, B3, B4, B5 
XI, X2, X3, X4, X6, X7 
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12.2.22 COMCSTF - SET TERMINAL FILE 

COMCSTF detects if a file is assigned to an interactive terminal. STF= is the only entry point for 
COMCSTF. 

Entry conditions: 
(Bl) 1 

(X2) Address of FET 

The FET must be greater than five words in length. 

Exit conditions: 

PC2) Address of FET 

(X6) If file Is assigned to a terminal 

Registers used: 

Al, A4 

XI, X3, X4, X6 

Calls: 
CIO= 

12.2.23 COMCSVR - SAVE ALL REGISTERS 

COMCSVR saves the B, A, and X registers in a specified register save area. The registers are saved 
in the following order: 

BO, Bl, . . . , B7, AO, Al, . . . , A7, XO, XI, . . . , X7 

Each register occupies a full word with the B and A register values in bits 17-0. B and A registers are 
sign extended. SVR= Is the only entry point for COMCSVR. 

Entry conditions: 

Bits 17-0 of the word from which SVR~ was called contain the address of the register save area. 

Exit conditions: 

(save thru save+7) B registers 

(save+8 thru save+15) A registers 
(save+16 thru save+23) X registers 

Registers used: 

AO, Al, A2, A3, A4, A5, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XO, XI, X2, X3, X4, X5, X6, X7 

12.2.24 COMCSYS - PROCESS SYSTEM REQUEST 

COMCSYS issues a system monitor request through RAM. SYS=, RCL=, WNB=, and MSG= are the 
entry points for COMCSYS. 
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SYS= - PROCESS SYSTEM REQUEST 

SYS= waits for RA+1 to clear before issuing the desired request. Central exclmnge jump hardware is 
used if it is available. If the hardware is not available and the auto-recall bit Is set, SYS= waits for the 
monitor to process the call before returning. 

Entry conditions: 

(X6) System request 
Exit conditions: 

Request processed 

Registers used: 

Al, A6 
X6 

RCI/= - PLACE PROGRAM ON RECALL 

RCL= Issues a single system request for periodic recall. If RA+1 Is busy, no request Is Issued. 
Exit conditions: 

Request processed. 
Registers used: 

Al 

XI, X6 
WNB= - WAIT NOT BUSY 

WNB= waits for a specified status word, bit 0, to be set. If the word Is Initially 0, WNB= returns. 
Entry conditions; 

(K2) Address of status word 
Exit conditions: 

Returns when bit of status word Is set. 
Registers used: 

Al 

XI, X6 

MSG= - SEND MESSAGE 

MSG= formats and Issues a system request to send a dayflle message. 
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Entry conditions: 

(XI) Address of data 
(X6) Message options: 

bit 16 - Auto recall if on 

bits 11 through - Message option code 

Exit conditions: 

Returns when operation is complete. 

Registers used: 

Al, A6 
XI, X6 



12.2.25 COMCUPC - UNPACK CONTROL CARD 

COMCUPC unpacks a control statement into the keyword and individual parameters. The foUowing 
conditions apply to the use of COMCUPC: 

« If B7 is negative on entry, a blank after the keyword is considered to be a separator; otherwise, blanks 
are ignored. 

• The characters ) and . are considered as the termination of the control statement. 

• Characters with display code values or 60B through 77B are illegal before the terminator, 

• The parameter must contain 7 or fewer characters. 

» The parameters are stored left-justified with zero fill. 

• The separator character is placed in the lower 18 bits of the parameter unless it is a in which case 
the lower 18 bits are zero. 

• Two successive separators or a separator followed by a terminator results in a parameter of all zeros. 
UPC= is the only entry point for COMCUPC. 

Entry conditions: 

{A5) Address of first word of control statement 
(Bl) 1 

(B7) First word address of buffer containing parameter information 
(X5) First word of control statement 

If B7 is negative, B7 contains the complement of the first word address of the parameter buffer. 
Exit conditions: 

(B6) Parameter count 

(X6) if no error during unpacking 

Registers used: 

Al, A2, A5, A6. A7 

82, B3, B4, B5, B6 

XO, XI, X2, X3, X4, X5, X6, X7 
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12.2.26 COMCWOD - CONVERT WORD TO OCTAL DJSPLAY CODE 



COMCWOD converts a wv>rd into octal display code. WOD== is the only entry point for COMCWOD. 

Entry condititms: 

(XI) Word to be coa verted 

Exit conditions: 

(Bl) 1 

CX6, X7) Cc«3versi<m 

Registers used: 

A2, A3, A4, AS 

XO. XI, X2, X3, X4, X5, X6, X7 



12.2.27 COMCWTC - WRITE CODED LINE, C FORMAT 

COMOa^TC writes a zero byte delimited line from a working buffer to a CIO b'offer. If the CIO buffer 
becomes sufficiently full to require writing or if the device type indicates a N OS/BE terminal, COMCWTC 
performs a WRITE function unless the symbol WRIF$ is defined. In this case, the CIO function that is in 
the FET is reissued. WTC=^ is ibe only enfry point for COMCWTC. 

Entry conditions: 

(Bo) F^A of working buffer 
(X2) Address of FET for file 

Exit conditioiis: 

(Bl) 1 

(X2) Address of FET for file 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3. B4, B5. B6 
XI, X2, X3, X4, X6, X7 

Calls: 

DCB=, WTX- 



12.2.28 COMCWTH - WRITE CODED LINE. H FORMAT 

COMCWTH writes a coded line in H formal from a working buffer to a CIO buffer. Trailing spaces are 
deleted. If the buffer becomes sufficiently full to require writing, or the device type indicates a NOS/BE 
terminal. COMCWTH performs a WRITE function unless the symbol WRIF$ is defined. In this case, the 
CIO function that is in the FET is reissued. If the line to be written terminates with 6 bits of zero, *a 
word containing a blank byte is appended to preserve the 00 character as a colon. If the line terminates 
on an end-of-line, it is written as is. WTH= is the only entry point for COMCWTH. 
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Entry conditions: 



(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 is 0, no transfer is performed. 



Exit conditions: 
(Bl) 1 

PC2) Address of FET for file 

Registers used: 

Al. A2, A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 



DCB=, WTX= 



12.2.29 COMCWTO - WRITE ONE WORD 

COMCWTO writes one word to a CIO buffer from X6. If the buffer becomes sufficiently full to require 
writing, CX)MCWTO performs a WRITE function unless the symbol WRIF$ is defined. In ttils case, the 
CIO function that is In the FET Is reissued. WTO= Is the only entry point for COMCWTO. 

Entry conditions: 

(Al) Address of IN pointer 
PCI) IN 

PC6) Word to write 
Exit conditions: 
(Bl) 1 

(X2) Address of FET for file 
Registers used: 

Al, A2, A3, A4, A6, A7 

Bl 

XI, X2, X3, X4, X6, X7 



12.2.30 COMCWTS - WRITE CODED LINE FROM STRING BUFFER 

COMCWTS writes a coded line from a working buffer to a CIO buffer with trailing space suppression. 
Characters In the working buffer are packed and stored in the circular buffer. If the buffer becomes 
sufficiently full to require writing or If the device type Indicates a NOS/BE terminal, COMCWTS perforns 
a WRITE function unless the symbol WRIF$ Is defined. In this case, the CIO function that Is In the FET 
Is reissued. WTS= Is the only entry point for COMCWTS. 
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Entry coadltlrais: 



(B6) FWA of workir^ buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 Is 0, no transfer Is performed. 



Exit cmditions: 



(Bl) 1 

(B6) Word count of data written 
(X2) Address of FET for file 



Begisters used: 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 



DCB=, WTX= 



12.2.31 COMCWTW - WRITE WORDS FROM WORKING BUFFER 

COMCWTW writes data from a working buffer to a CIO buffer. If the buffer becomes sufficiently full to 
require writing or If the device type Indicates a NOS/BE terminal, COMCWTW performs a WRITE 

^i^'"''^^^^ ^^"^^""^ WR^F^ ^® defined. In this case, the CIO fimctlon that Is In the FET Is reissued. 
WTW=, DCB=, and WTX= are the entry points for COMCWTW. 

Entry conditions: 

(B6) FWA working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 is 0, no transfer Is performed. 

Exit conditions: 



(Bl) 1 

(B6) Address of next word to be transferred from working buffer 

(B7) Status of transfer: 

Transfer completed 

nros ^/^^iPi^^ Y?""^ ^ "^^^ called to write data and returned an error status 

[AZf Address oi FET for file 

Pf7) Error status If B7 Is 



Registers used: 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3, B4. B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 



CIO 
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12.2.32 COMCXJR - RESTORE ALL REGISTERS WITH A SYSTEM XJR CALL 



COMCXJE restores all registers from a register save area with a system XJR call. The format of the 

registers in the save area is BO, Bl, . . . , B7, AO, Al A7, XO. XI, ... , X7. Each register 

occupies a full word with the JB and A register values in bits 17-0. X.IB= is the only entry point for 
COMCXJB. 

Entry conditions: 

(XI) Address of the register save area. 
Exit conditions: 

All registers are set to the contents of the register save area. 
Registers used: 

AO, Al, A2, A3, A4, A5, A6, A7 
BO, Bl, B2, B3, B4, B5, B6, B7 
XO, XI, X2, X3, X4, X5, X6, X7 



12.2.33 COMCZTB - CONVERT ALL 00 CHARACTERS TO BLANKS 

COMCZTB converts all 00 characters in a word to blanks. ZTB= is the only entry point for COMCZTB. 
Entry conditions: 
(Bl) 1 

(XI) Word to be converted 

Exit conditions: 

(X6) Converted word 

(X7) Final character mask 

Registers used: 

A3 

X3, X6, X7 



12.3 MACROS THAT CALL THE COMMON COMMON DECKS 

Entry pomts in the common common decks can be called by using system macros. Table 12-3 shows 
which macros call entry points in the common common decks. All of the macros are supported under 
NOS and NOS/BE. Only the MOVE macro is supported under SCOPE 2. All macros applicable to a 
given operating system exist in the system text CPUTEXT. Each macro is described in detail in the 
following paragraphs. 



12.3.1 MESSAGE 

MESSAGE displays a message on the system console display and enters it into a dayfile. If the job Is of 
system origin, the message can be flashed on the B display by Including a dollar sign as the first charac- 
ter of the message. MESSAGE requires the common common deck COMCSYS. 
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TABLE 12-3. MACROS THAT CALL COMMON COMMON DECKS 



Macro 


Entry Points 
Called 


Description 


MESSAGE 


MSG= 


Displays a message on the system 
console and enters it in a dayfile. 


MOVE 


MVE= 


Moves a block of data from one 
address to another. 


READC 


RDC= 


Reads one coded line from the input/output 
buffer to the worlcing buffer. 


READH 


RDH= 


Reads one coded line with space fill from 
the input/output buffer to the working 
buffer. 


RE ADO 


RDO= 


Reads one word from the input/output 
buffer to X6. 


READS 


RDS= 


Reads a line image to a character 
buffer. 


READW 


RDW= 


Fills the working buffer from an 
input/output buffer. 


RE CA LL 

X\JL^ \^aT^ XJXJ 


WNB= 


Relinquishes the CPU until a 
function is completed or tte CPU 
recall time has elapsed. 


SYSTEM 


SYS= 


Requests the system to process 
any three-character request. 


WEITEC 


WTC= 


Writes a coded line image from the working 
buffer to the input/output buffer. 


WE 11 E H 
_ — . 


WTH= 


Writes a coded line, deleting all 
trailing spaces, from the working 
buffer to the input/output buffer. 


WRITE 


WTO= 


Writes one word from X6 to the 
input/output buffer. 


WRITES 


WTS= 


Writes a line image from the 
character buffer. 


WRITE W 


WTW= 


Writes data from the working 
buffer to the input/output buffer. 
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The maximum length that a message can be is 80 characters; up to 40 characters per line are di.nlnv.rl 
Ihe message ends with either the first word containing 12 hit, of zeros iS byte or aT tte eifhtfe^h 
character. The user must pack the display coie message in sequential locatfonHefLe ctliri' MESSAGE, 

The format of the RAfl call for this macro is: 



40 



35 



23 



17 



RA+1 



MSG 



addr 



Macro formal: 



tOCATlON 


OPfRATlON 


vASiABit susfiaos 




MESSAGE 


addr,x,r 



addr 



Beginning address of the message. If the upper 12 bits of the location specified by this 
address are zero, then the next 18 bits (47 thru 30) of this location are assumed to contain 
the beginning address of the message. contain 

Message routing option: 




Message is placed in the system dayfile, the user dayfile, and is displayed at line 1 of 
the control point. * 

Message is displayed at line 1 of the control point. 

Message is displayed at line 2 of the control point. 

Message is placed in the user dayfile and displayed at line 1 of the control poi.il. 
Message is placed in the error log dayfile if the job is a special system job (that is, has 
dayffle!'^ """" ^^^^ ^ °' "^''^"^ ^^e message is placed in the user 

5 Message is placed in the account dayfile if the job is a special system job or is of system 
origin; otherwise, the message is placed in the user dayfile. ^ 

6 Message is placed in the system dayfile, the user dayfile, and is displayed at line 1 of 
the control point. f j i x u.. 

7 Message is placed in the user dayfile and displayed at line 1 of the control point. 

If X is not specified or is an illegal value, x=0 is assumed. If x is not defined, x=l is 
assumed. If x is the character string LOCAL, x-3 is used. 

r If r is specified, control is not returned until the operation is complete. 

The control point message areas (lines 1 and 2) provide the user with the ability to display concurrentlv 
messages that enter the dayfile and those that require operator action. Line 2^ norS useT o di^^^^^ 
mformaiion about the current status of the executing program. normauy used .o display 

^n^ivr? '■''^^^ ""^^ ^^^^t^o^ statements processed and compilers used 

b^t^n." ^ ^"^H "'"'''T "messages that refer to the job, such as Sie path t^Ken ' 

by the programs and tlie number of records copied, should be placed only in he user dayf le fx=3) Ai^ 
messag^es placed m the user dayfile (x^O and x=6) are counted by the sysfem. If numi^er of niLaiL 
issued by the job exceeds the limit for wnich the user is validated, the erroi^ mLsao" MF^SAGr^^^^^ 
is issued to the user dayfile and the job is aborted. message iMLbbAGE LIMIT, 
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12.3.2 MOVE 

MOVE moves a block of data from one address to another. MOVE requires the common common deck 
COMCiy'P/E for absolute assemblies. 

Macro forma-:: 



lOCATlON 


OP£«AT!ON 


VARlABtf SUBFIEIDS 




MOVE 


count, ad(Jrl, addr2 



count Number of words in the block to be moved 

addrl Address of the first word of the block to be moved 

acklr2 Address of the first word of the destination 



MOVE allows overlap in data moves (addr2 can be less than addrl plus count). 
12.3.3 READC 

RE ADC reads one coded line from the input/output buffer to the working buffer. Data is transferred 
until the end of the line (0000 in bits 11 through 0) is sensed or until the specified number of words are 
transferred. READC requires the common common deck COMCRDC. 

Macro formal; 



lOCATION 


OPf«ATION 


VASIAJIE SUBflELDS 




READC 


addr,buf, n 



addr FET address 

buf Working buffer address 

n Working buffer word count 



12.3.4 READH 

READH reads a coded line with space fill from the input/output buffer to the working buffer. Data is 
transferred until the end of the line (0000 in bits 11 through 0) is sensed or until the specified number of 
words are transferred. READH i-equires the common common deck COMCRDH. 

IMacro formai: 



lOCATlON 


OPERATtON 


VASIABlE SUSFlEtOS 




READH 


addr, buf, n 
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addr 

buf 

n 



FET address 

Working buffer address 

Working buffer word count 



12.3.5 READO 

EEADO reads one word from the input/output buffer to X6. READO requires the common common deck 
COMCRDO. 

Macro format: 



tOCATION 


OPESATtON 


VAIIABtl SU8fl£lOS 




READO 


addr 



addr FET address 

12.3.6 READS 

READS reads a line image to a character buffer. The words are unpacked and stored in the working 
buffer right justified, one character per word, until the end-of~byte (0000) is detected. If the coded 
line terminates before the specified number of characters are stored, the working buffer is blank filled. 
READS requires the common common deck COMCRDS. 

Macro format: 



lOCATION 


OP£«ATION 


VAtiASlE SUtFIElDS 




READS 


addr, buf, n 



addr FET address 

buf Working buffer address 

n Working buffer word count 

12.3.7 READW 

READW fills tlie working buffer from an input/output circular buffer. READW reads ahead in the Input/ 
output buffer. This could cause the program to abort if the last word address of the input/output buffer is 
within four words of the FL. If the word count is greater than the length of the working buffer, READW 
writes beyond the end of the working buffer. READW requires the common common deck COMCRDW. 

Macro format: 



LOCATION 


OPMATION 


VARIAtU SUtFtElOS 




READW 


addr, buf, n 
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addr FET address 

buf Working buffer address 

n Working buffer word count 

12.3.8 RECALL 

RECALL enables the user to relinquish the CPU until a function is completed or the CPU recall time has 
elapsed (delay time depends on the operating system and the site). If the stat parameter is Included in the 
call, control is not returned to the program until bit of the word specified by stat is set. If stat is not 
included in the macro call, the program relinquishes the CPU atily until the next pass through the recall 
loop. RECALL requires the common common deck COMCSYS. 

The format of the RA+1 call for this macro is: 



RA+1 



59 






40 




17 







RCL 




r 





Stat 



Macro format: 



lOCATtON 


OPEIiATION 


VARIABU SUSflElDS 




RECALL 


Stat 



stat If this parameter is present, control Is returned to the program when bit of the word 

specified by the address stat Is set. 

12.3.9 SYSTEM 

SYSTEM processes a three-letter request. The request can be either the functions that MTR performs 
or a PPU prc^ram. A PPU program can be called from a CPU program if the first character of the 
name is a^habetic. SYSTEM requires the common common deck COMCSYS. 

The format of the RA+1 call for this macro is: 

59 40 35 17 



RA+1 




Macro format: 



lOCATION 


OPERATION 


VASIAItE SUBflElDS 




SYSTEM 


req,r,pl,p2 
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req Three-character system request 

r If specified, control is returned only after the request is completed 

pi Bits 17 through of the request 

p2 Bits 35 through 18 of the request 

12.3.10 WRITEC 

WRITE C writes a coded line image from the working buffer to the input/output buffer. Data Is trans- 
ferred until the end of the line (0000 in bits 11 through 0) Is sensed. WRITEC requires the common 
common deck COMCWTC. 

Macro formats 



LOCATION 


OPEIATION 


VAIIAIIE SUIFIEIOS 




WRITEC 


addr,buf 



addr FET address 

buf Working buffer address 

12.3.11 WRITEH 

WRITEH writes a coded line, deleting all trailing spaces, from the working buffer to the Input/outpHit 
buffer. WRITEH requires the common common deck COMCWTH. 

Macro format: 



lOCATION 


OPEtATION 


VARIABLE SUIFIELDS 




WRITEH 


addr, buf, n 



addr FET address 

buf Working buffer address 

n Working buffer word count 



12.3.12 WRITEO 

WRITE O writes one word from X6 to the li^ut/output buffer. WRITEO requires the common common 
deck COMCWTO. 
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Macro format: 



lOCATION 


OPE«ATlON 


VARIAtlE SUSFIEIDS 




WRITEO 


addr 



addr FET address 

12.3.13 WRITES 

WRITES writes a line Image from the working buffer. Characters are packed ten characters per word. 
Trailing spaces are deleted before the characters are packed. WRITES requires the common common 
deck COMCWTS. 

Macro format: 



lOCATION 


OHIATION 


VARIAIIE SUMIEIDS 




WRITES 


addr, buf, n 



addr FET address 

buf Working buffer address 

n Working buffer word count 



12.3.24 WRITEW 

WRITEW writes data from the working buffer to the input/output circular buffer. WRITEW writes ahead 
in the input/output buffer. This could cause the program to abort if the last word address of the input/ 
output buffer Is within four words of the FL. If the word count is greater than the length of the working 
buffer, WRITEW reads beymd the end of the working buffer. WRITEW requires the common common 
deck COMCWTW. 

Macro format: 



lOCATION 


OPERATION 


VASIASIE SUSFIEIOS 




WRITEW 


addr, buf, n 



addr FET address 

buf Working buffer address 

n Working buffer word count 
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CHARACTER SETS 



A 



NOTES 



1. The terms upper case and lower case apply only to the case conversions, and 
do not necessarily reflect any true case, 

2. When translating from display code to ASCn/EBCDIC the upper case equivalent 
character is taken. 

3. When translating from ASCII/EBCDIC to display code, the upper case and lower 
case characters fold together to a single display code equivalent character. 

4. All ASCn and EBCDIC codes not listed are translated to display code 55 (space). 

5. Where two display code graphics are shown for a single octal code, the leftmost 
graphic corresponds to the CDC 64--character set (system assembled with IP CSET 
set to C64. 1), and the rightmost graphic corresponds to the CDC 64-character 
ASCII subset (system assembled with IP CSET set to C64.2). 

6. In a 63-character set system, the display code for the : graphic is 63, The % 
character does not exist, and translations from ASCII/EBCDIC % or ENQ yield 
blank (55^). The display code value 00 is undefined in 63-character set systems, 

7. Twelve or more zero bits at the end of a 60-bit word are interpreted as an 
end-of-line mark rather than two colons. An end-of-line mark is converted to 
external BCD 1632 and internal BCD 1672 by operating systems when writing 
7-track magnetic tape in even parity (coded) mode, and converted back to 0000 
when reading. 

8. This code is changed to 12 when written on a 7-track magnetic tape in even 
parity (coded) mode. 

9. 11-0 and 11-8-2 are equivalent on input. The character will be punched as 

11- on output. 

10. 12-0 and 12-8-2 are equivalent on input. The character will be punched as 

12- on output. 

11. 12-8-7 and 11-0 are equivalent on input. The character will be punched as 
12-8-7 on output. 

12. 12-8-4 and 12-0 are equivalent on Input. The character will be punched as 
12-8-4 on output, 

13. CODE pseudo selects 6-bit octal code as follows: 



A 
D 
E 
I 



ASCII 

Display Code (default) 
External BCD 
Internal BCD 



CODE D (default) ^^^^ ^CX)DE I 



Display 


HoIIeritl; 


BCD 








ASCU 












Code 


Punch 
(026) 






6-Bil 


Upper Case 




Lower Case 


Upper Lower 


Octal 


Char. 




Ext. 


@ 


Octal 
© 


Hex. 


Char. 


Punch 
(029) 


Hex. 


Char. 


Ptmch 


Hex. 


Char. 


Hex. 


Char. 


00 


(7) 


8-2 


00® 




32 


3A 


• 


8-2 


lA 


SUB 


9-8-7 


7A 


. 


3F 


SUB 


01 


A 


12-1 


61 


21 


41 


41 


A 


12-1 


61 


a 


12-0-1 


CI 


A 


81 


a 


02 


B 


12-2 


62 


99 


42 


42 


fi 


12-2 


62 


b 


12-0-2 


C2 


B 


82 


b ; 


03 


C 


12-3 


63 




43 


43 


C 


12-3 


63 


c 


12-0-3 


C3 


C 


83 


c 


04 


D 


12-4 


64 


24 


44 


44 


D 


12-4 


64 


d 


12-0-4 


C4 


D 


84 


d 


05 


£ 


12-5 


65 


25 


45 


45 


£ 


12-5 


65 


e 


12-0-5 


C5 


£ 


85 


e 


06 


P 


12"6 


66 


26 


46 


46 


P 


12-6 


66 


f 


12-0-8 


06 


F 


86 


f 


07 


G 


12-7 


67 


27 


47 


47 


G 


12-7 


V 1 


g 


12-0-7 


07 


G 


87 


g 


10 


H 


12-8 


70 


30 


50 


48 


H 


12-8 


68 


h 


12-0-8 


C8 


H 


88 


h 


11 


I 


12-9 


71 


31 


51 


49 


I 


12-9 


Da 


1 


12-0-9 


C9 


I 


89 


i 


12 


J 


11-1 


41 


41 


52 


4A 


J 


11-1 


6A 


J 


12-11-1 


Dl 


J 


91 


J 


13 


K 


11-2 


42 


42 


S3 


4B 


K 


11-2 


6B 


k 


12-11-2 


D2 


K 


92 


k ; 


14 


L 


11-3 


43 


43 


54 


4C 


L 


11-3 


6C 


I 


12-11-3 


D3 ^ 


< L 


S3 


1 


15 


M 


11-4 






55 


4D 


M 


11-4 


6D 


m 


12~llr*4 


D4 


M 


94 


m ' 


16 


N 


11-5 


45 


45 


56 


4E 


N 


11-5 


6£ 


n 


12-11-5 


D5 


N 


95 


n 


17 


O 


11-6 


46 


46 


57 


4F 


O 


11-6 


6r 


o 


12-11-6 


D6 





96 


° i 


20 


P 


11-7 


47 


47 


60 


50 


P 


11-7 


70 


P 


12-11-7 


D7 


P 


97 


P 


21 


Q 


11-8 


50 


50 


61 


51 


Q 


11-8 


71 


q 


12-11-8 


D6 




98 


q i 


22 


R 


11-9 


51 


Ox 


62 


52 


R 


11-9 


72 


r 


12-11-9 


D9 


R 


99 


r i 


23 


s 


0-2 


22 


62 


63 


CO 

Do 


Q 


0-2 


73 


s 


11-0-2 


£2 


S 


A2 




24 


T 


0-3 


23 


63 


64 


54 


T 


0-3 


74 


t 


11-0-3 


£3 


T 


A3 


" i 
t 


25 


U 


0-4 


24 


64 


65 


55 


U 


0-4 


75 


u 


11-0-4 


£4 


U 


A4 


u 


26 


V 


0-5 


25 


65 


66 


56 


V 


0-5 


76 


V 


11-0-5 


ES 


V 


AS 


V 


27 


w 


0-6 


26 


66 


67 


57 


w 


0-6 


77 


w 


11-0-6 


£6 


w 


A6 


w 


30 


X 


0-7 


27 


67 


70 


58 


X 


0-7 


78 


X 


11-0-7 


E7 


X 


A7 


X 


31 


Y 


0-8 


30 


70 


71 


59 


Y 


0-8 


79 


y 


11-0-8 


£8 


Y 


A8 


y 


32 


z 


0-9 


31 


71 


72 


5A 


Z 


0-9 


7A 


z 


11-0-9 


£9 


z 


A9 


' z 


33 








12 


00 


20 


30 








10 


DLE 


ia-11-9-8-1 


FO 





10 


DLE 


34 


1 


1 


01 


01 


21 


31 


1 


1 


11 


DCl 


11-9-1 


Fl 


1 


11 


DCl 


35 


2 


2 


02 


02 


22 


32 


2 


2 


12 


DC2 


11-9-2 


F2 


2 


12 


DC2 


36 


3 


3 


03 


03 


23 


33 


3 


3 


13 


DCS 


11-9-3 


F3 


3 


13 


TM 


37 


4 


4 


04 


04 


24 


34 


4 


4 


14 


DC4 


11-9-4 


F4 


4 


3C 


DC4 
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CX>OE D «l8failt) j C50DE 

1 I \ 



Cod 

Octal 


ay 

b 

Cbar. 


Holl«rl& 
Punch 
C026) 


BC 

EKt. 

@ 


*D 

bit. 

® 


6-Blt 
Octal 
@ 


Upp 
Hex. 


er Cue 

Cl^. 


ASCI! 

Punch 
(029) 


Hex. 


Lower 
Cttsx, 


Case 

Funds 


Up) 
Hex. 


EBC 

[Mr 

Qmr. 


Die 
Hex. 


iver 
Char. 


40 


5 


S 


05 




25 


35 


5 


6 


IS 


NAK 


9-8-5 


F5 


5 


3D 


NAK 


41 


6 


6 


06 


06 


26 


38 


6 


6 


16 


BYH 


9-2 


F6 


6 


32 


SYN 


42 


7 


7 


©7 


07 


27 


37 


7 


7 


17 


ETB 


0-9-6 


F7 


7 


26 


ETB 


43 


8 


% 


10 


10 


SO 


38 


8 


8 


18 


CAN 


11-9-8 


F8 


8 


18 


CAN 


44 





8 


11 


11 


31 


39 


9 


9 


19 


EM 


11-9-8-1 


P9 


9 


19 


EM 


45 


+ 


12 


60 


20 


13 


2B 


+ 


12-8-6 


OB 


VT 


12-9-8-3 


4£ 


+ 


OB 


VT 


46 




11 


40 


40 


15 


2D 




11 


OD 


CR 


12-9-8-5 


60 




OD 


CR 


47 




11-8-4 


54 


54 


12 


2A 




11-8-4 


OA 


LF 


0-9-5 


5C 




25 


LF 


SO 


/ 


0-1 


21 


61 


17 


2F 


/ 
/ 


0-1 


Q¥ 


SI 


12-9-8-7 


61 


/ 


OF 


SI 


61 


( 


0-8-4 


34 


74 


10 


28 


< 


12-8-5 


08 


BS 


11-9-6 


4D 


( 


16 


BS 


Oi 


) 


lis- 8— 4 


fA 

74 


Oil 

34 


11 


29 


) 


11-8-5 


09 


HT 


12-9-5 


5D 


) 


Uo 


HT 


oa 


* 


11-8-3 


03 


OS 


AA 
04 


24 




11-8-3 


04 


EOT 


9-7 


SB 




87 


EOT 


94 




8-3 


13 


13 


35 


3D 




8-6 


ID 


GS 


11-9-8-5 


7E 




ID 


IGS 


65 


space 


space 


20 


60 


00 


20 


space 


space 


00 


NUL 


12-0-9-8-1 


40 


space 


00 


NUL 


56 


• 


0-8-3 


S3 


73 


14 


2C 


• 


0-8-3 


OC 


FF 


12-9-8-4 


6B 




OC 


FF 


57 




12-8-3 


73 


S3 


16 


2E 


• 


12-8-3 


OE 


SO 


12-9-8-6 


4B 


• 


OE 


SO 


60 


0-8-6 


36 


76 


03 


23 


# 


8-3 


03 


ETX 


12-9-3 


7B 


# 


03 


ETX 


61 


{ 


8-7 


17 


17 


73 


SB 


( 


12-8-2 


IC 


FS 


11-9-8-4 


4A 




IC 


IFS 


62 

63 




0-8-2 
8-6 


32 
16 


72 
16 


75 
OS 


5D 

25 


1 

% 


11-8-2 
0-8-4 


01 
05 


SOH 

Em 


12-9-1 
0-9-8-5 


SA 
6C 


i 

% 


01 
2D 


SOH 
ENQ 


64 




8-4 


14 


14 


02 


22 


•« 


8-7 


02 


STX 


12-9-2 


7F 


M 


02 


^ 1 

STX I 


65 
66 


r- 

V 1 


0-8-5 

u-o® 


35 
52 


75 
52 


77 
01 


5F 
21 


1 


0-8-5 
12-8-7® 


7F 
7D 


DEL 

1 


12-9-7 
11-0 


6D 
4F 


1 


07 
DO 


DEL < 

} : 


67 


A k 


0-8-7 


37 


77 


06 


26 


ft 


12 


06 


ACK 


0-9-8-6 


50 


& 


2E 


ACK 


70 


\ • 


11-8-5 


55 


55 


07 


27 


1 


8-5 


07 


BEL 


0-9-8-7 


7D 


t 


2F 


BEI, 


71 




11-8-6 


56 


66 


37 


3F 


? 


0-8-7 
12-8-4© 


IF 


US 


11-9-8-7 


6F 


? 


IF 


lUS 


72 


< 


12-0® 


72 


32 


34 


SC 


< 


7B 


1 


12-0 


4C 


< 


CO 


1 


73 


> 


11-8-7 


57 


67 


36 


3E 


> 


0-8-6 


IE 


RS 


11-9-8-6 


6E 


> 


IE 


IRS 


74 


< @ 


8-5 


15 


IS 


40 


40 




8-4 


60 




8-1 


7C 




79 


\ 1 

1 


75 


i \ 


12-8-5 


75 


35 


74 


50 




0-8-2 


7C 


■1 


12-11 


EO 


\ 


6A 




76 


n A 


12-8-6 


76 


36 


76 


5E 


A 


11-8-7 


7E 


<v 


11-0-1 


6F 




Al 




77 




12-8-7 


77 


37 


33 


SB 


• 


11-8-6 


IB 


ESC 


0-9-7 


5E 


i 


27 


ESC 
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First 



-iexadc 
1 


icimal 
2 


Digit 
3 


4 


5 


6 


7 


8 




A 


B 


C 





E 


F 


Second 


000 


020 


040 


060 


100 


120 


140 


160 


200 


220 


240 


260 


300 


320 


340 


360 


Digit 1 


001 


021 


041 


061 


101 


121 


141 


161 


201 


221 


241 


261 


301 


321 


341 


361 


2 


002 


022 


042 


062 


102 


122 


142 


162 


202 


222 


242 


262 


302 


322 


342 


362 


3 


003 


023 


043 


063 


103 


123 


143 


163 


203 


223 


243 


263 


303 


323 


343 


363 


4 


004 


024 


044 


064 


104 


124 


144 


164 


204 


224 


244 


264 


304 


324 


344 


364 


5 


005 


025 


045 


065 


105 


125 


145 


165 


205 


225 


245 


265 


305 


325 


345 


365 


6 


006 


026 


046 


066 


106 


126 


146 


166 


206 


226 


246 


266 


306 


326 


346 


366 


7 


007 


027 


047 


067 


107 


127 


147 


167 


207 


227 


247 


267 


307 


327 


347 


367 


8 


010 


030 


050 


070 


110 


130 


150 


170 


210 


230 


250 


270 


310 


330 


350 


370 


9 


Oil 


031 


051 


071 


111 


131 


151 


171 


211 


231 


251 


271 


311 


331 


351 


371 


A 


012 


032 


052 


072 


112 


132 


152 


172 


212 


232 


252 


272 


312 


332 


352 


372 


B 


013 


033 


053 


073 


no 


i 'i'3 
1 




1 to 


<e lO 






^ /o 


O i o 




353 


373 


C 


014 


034 


054 


074 


114 


134 


154 


174 


214 


234 


254 


274 


314 


334 


354 


374 


D 


015 


035 


055 


075 


115 


135 


155 


175 


215 


235 


255 


275 


315 


335 


355 


375 


E 


016 


036 


056 


076 


116 


136 


156 


176 


216 


236 


256 


276 


316 


336 


356 


376 


F 


017 


037 


057 


077 


117 


137 


157 


177 


217 


237 


257 


277 


317 


337 


357 


377 


Octal 


000- 


037 


040- 


077 


100- 


137 


140 


177 


200 


237 


240 


277 


300 


337 


340 


377 



60492600A 



ASSEMBLY-TIME I/O 



B 



SCOPE 2 

COMPASS 3 under SCOPE 2 uses the Record Manager for all of its I/O operations. Thiis, COMPASS 3 
can read and write files with a variety of external formats. For each of the files used by COMPASS, 
the default format, and the combinations of file format description parameters that may be specified in 
FILE control statements to override the defaults, are given below. 



Main Source Input File 

The main source input file may be a normal source input file or a compressed compile file; COMPASS 
determines which it is by inspecting the data in the file. A normal source input file under SCOPE 2 
comprises the following: 



File Organization (FO) 

Block Type (BT) 

Maximum Block Length (MBL) 

Record Type (RT) 

Maximum Record Length (MRL) 

Conversion Mode (CM) 

Label Type (LT) 



sequential ^) 

unblocked 

none 

control word (W) 
100 chars. 
NO 

unlabeled (UL) 



The only other formats that may be specified by FILE control statements are as follows (X=allowed, 
-=not allowed); 



Block 




Record 


Type 


Type 


F 


W 


Z 


unblocked 


X 


X 




C 


X 


X 


X 


I 




X 





File Organization (FO) must be sequential (SQ). 

Maximum Record Length (MRL) must not exceed 160 characters. 

Label Type (LT) may be any value supported by the operating system, 

Althoi^h the maximum record lengfli may be as large as 160 characters, only the first 90 char- 
acters of each record are reproduced in the listing output files. 
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If the file Is a compressed compile file (written by UPDATE in X mode or MODIFYf in A mode), 
COMPASS sets the file format description parameters to resemble normal input; however, MRL = 
5120 characters. 

Listing Output FUea 

The default format under SCOPE 2 comprises the following: 



File Organization (FO) 

Block Type (BT) 

Msiximum Block Length (MBL) 

Record Type (RT) 

Maximum Record Length (MRL) 

Conversion Mode (CM) 

Label Type (LT) 

The only other formats that may be specified by 
-«not allowed): 



Block 


Record 


Type 


Type 


F 


w 


Z 


unblocked 


X 


X 




C 


X 


X 


X 


I 




X 





File Organization (FO) must be sequential (SQ). 

Maximum Record Length (MRL) must not exceed 137 characters. 

Label Type (LT) may be any value supported by the operating system. 



sequential (SQ) 

imblocked 

none 

control word (W) 
137 chars. 
NO 

Unlabeled (UL) 
FILE control statements are follows pC«allowed, 



Binary Output File 

FILE control statements can be used under SCOPE 2 to specify the format of binary output files for any 
of the operating systems, such that a program can be assembled under SCOPE 2 and the object program 
executed under a different system if so desired. 



tMODIFY is not available under SCOPE 2. 
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NOS and NOS/BE 1 



File Organization (FO) 



sequential (SQ) 



sequential (SQ) 



Block Type (BT) 



unblocked 



character count (C) 



Maximum Block Length (MBL) 
Record Type (RT) 
Maximum Record Length (MRL) 
Conversion Mode (CM) 



NO 



control word (W) 



none 



1,310,710 chars. 



NO 



system- logical-record (S) 



5120 chars. 



none 



Label Type (LT) 



Unlabeled (UL) 



ANY 



No other formats are allowed, except that the label type (LT) can be any value supported by the operating 
system used for assembly. The format shown above under SCOPE 2 is the default binary output file format 
under that system. 

Scratch Files 

COMPASS uses two scratch files named ZZZZZRL and ZZZZZRM. when table storage space overflows. 
Regardless of what is specified by FILE control statements. COMPASS sets the file format description 
parameters for these files under SCOPE 2 as follows: 

FUe Organization (FO) = sequential (SQ). 

Conversion Mode (CM) = NO. 

For fUe ZZZZZRL: 

Block Type (BT) = unblocked. 

Maximum Block Length = 5120 characters. 

Record Type (RT) = undefined (U) Maximum Record Length = 2550 characters. 
For fUe ZZZZZRM: 

Block Type (BT) = character count (C), Maximum Block Length = 5120 characters. 
Record Type (RT) = SCOPE logical (S), no Maximum Record Length. 

ALL OPERATING SYSTEMS 

System Text Input Files 

A user library file designated by an S parameter on the COMPASS control statement must have the 
standard library file format for the system <mi which COMPASS is being used.^ COMPASS uses the 
operating system overlay loader to access these files. 

For a sequential binary (non-library) file designated by a G parameter on the COMPASS control statement, 
the default and permitted formats are the same as those given above for the COMPASS binary output file. 



^Overlay residence in user libraries is not currently supported by NOS. 
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XTEXT Input Files 



A file read by COMPASS when processing an XTEXT pseudo instruction can have any of several formats. 
COMP/kSS determines the file format (a) by whether the XTEXT pseudo instruction variable field is empty 
and (b) by inspecting the data in the file. 

If the variable field is empty, the File Organization (FO) must be sequential (SQ). COMPASS rewinds the 
file and reads until end of section or a COMPASS END statement is encountered, whichever comes first. 
The default and permitted formats under SCOPE 2 are the same as those given above for the main source 
input file. 

If the XTEXT variable field is non-empty, the file organizaticwi can be any of three non-standard types: 
• Record inctexed with name index (under SCOPE 2 only). 

m SCOPE 3.3 style random file with name index (not supported under SCOPE 2). 

I . update or Modifyt random program Ubrary file. 

In each case, COMPASS sets the file format description parameters to the appropriate values; no FILE 
control statement is needed. 



The record indexed file organization is actually the word addressable (WA) file organization with a set of 
format conventions superimposed on it. Such a file can be created by a FORTRAN program by using the 
library subroutines OPENMS, STINDX, WRITMS, and CLOSMS with a name index, or by a COBOL program 
I specifying ORGANIZATION IS WORD-ADDRESS, WORD-ADDRESS IS data-name. When COMPASS detects 
such a file under SCOPE 2, it sets the file format description parameters as follows (no FILE card is 
needed); 

• File Or^nization (FO) = word addressable (WA). 

• Block Type (BT) = unblocked. 

• Record Type (RT) = control word (W); Maximum Record Length (MRL) = 160 characters. 

• Conversion Mode (CM) = NO. 

• COMPASS positions the file at the record pointed to by the index entry containing the name given in 
the XTEXT statement variable field, and then reads records sequentially until end of section or a 
COMPASS END statement is encountered, whichever comes first. 

The SCOPE 3.3 style random file with name index is permitted for compatibility with previous versions of 
COMPASS. When COMPASS detects such a file, it searches the file index and positions the file at the 
beginning of the specified section, and then reads sequentially until end of section or a COMPASS END 
statement is encountered, whichever comes first. Such files cannot be used with SCOPE 2. 

I An Update or Modify^ random program library file is processed similarly. The name in the variable field of 
the XTEXT statement must be the name of a common deck. When COMPASS detects such a file under 
SCOPE 2, it sets the file format description parameters as follows (no FILE control statement is needed): 



I "^Modify is not avaUable under SCOPE 2 or NOS/BE 1. 
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File Organization (FO) = word addressable (WA), 
Block Type (BT) = unblocked 

Record Type (RT) = control word (W), Maximum Record Length (MRL) = 5120 characters 
Conversion Mode (CM) = NO 

COMPASS positions the file at the first card image of the designated section (common deck). For 
an UPDATE program library, the first active card image (the *COMDECK card) is skipped. 
COMPASS then reads card images sequentially, ignoring inactive card images, until end of section 
or a COMPAQ END statement is encountered, whichever comes first. 
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BINARY CARD FORMATS 



Column 1 



7, 8, 9 levels to 16 
6,7.9 

6,7,8,9 or 7, 8,9 level 17 
7,9 

7 and 9 not both In column 1 



End-of-secticm 
End-of-partltlon (NOS only) 
End-of-informatlon 
Binary card 
Coded card 



12 


/ 


11 









1 


Com 


2 
3 


Word 


4 




5 




6 




7 




8 




9 





1 2 3 4 5 



-Column Binary Information 



o 
a 

0) 
3 



A binary card can contain up to 15 60-bit CPU words starting at column 3. Column 1 also contains 
a count of 60-bit words in rows 0, 1. 2. and 3plus a check indicator to row 4. If row 4 of column 1 is 
zero, column 2 is used as a checksum for the card on input; if row 4 is one, no check is performed on 

Column 78 of a btoary card is not used, and columns 79 and 80 contain a binary serial number. If a 
section is punched, each card has a checksum in column 2 and a serial number in columns 79 and 80, 
which sequences it within the logical record. 
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HINTS ON USING COMPASS 



D 



mmmmMmmmnmm, -iii i'»iiMMwiiiuM.»MMmuu«>MMM^^ | ii || | | , | | | | | | | || || ||| | | | | | riliaMll||||[|Bn^^ 

1. Within a macro definition: 

• Use comment statements having * in column one. These are not saved, whereas other types of 
comments are saved. 

• Whenever possible, minimize the number of lines of code, 
o IRP is faster than either ECHO or DUP. 

« Use the substitute parameter flags ;A, ;B, and so forth, for macros, to avoid a second line. 

• Within macros, use symbols such as .1, .2, and so forth, instead of local symbols. 

o If possible, avoid recursive macro structure to increase assembly speed. 

9 If a macro call is the cause of an error, direct full list output to a file other than OUTPUT 
(L=filename) to obtain a list of the erroneous macro call with the error listing. 

2. In IF sequences: 

« Use line counts rather than ENDIF to terminate sequences, 
e Use SKIP rather than IFPP to skip code. 

3. MacrcMi: 

«» Micro replacement is time-consumir^. 
® Avoid using local symbols for micros. 

• Use ^ ^ f or a null substituticHi. 

4. Minimize SYSTEXT size. 

5. To reduce core requirements, use SEG statements in absolute programs. 

6. Use NOREF for symbols for which listing is not required. 

7. Use QUAL for all overlays. 

The program EXAMPLE (figure D-1) presents fundamental program crganization. It also demonstrates 
some COMPAQ coding conventions and illustrates efficient coding practice. The program obtains numbers 
from six successive locations, adding the numbers one at a time to the running sum. The total is then 
printed with a label. 



60492600 a 



D-1 



9 



1 








r neuT 

1 w C 1 


c A •* n c 




2 








ENTRY 


5* C VP * 




3 









Cf J* «9 




OUTPUT gltt^PFP 


4 


301 


172524 20252400000001 


OUTPUT 


FILEC 


0BUF»3018 




5 


306 


6110000001 


BEGIH 


SSI 


I 




6 




66200 




S82 


BO 


INITIALIZE ADDRESS CflUMTfEt Tfl Ffftn 


7 


307 


6130000006 




SB3 




SET FOR USE AS A LOOP LIMIT 


g 




43100 




HXl 





INITIALIZE RUNNIH6 SUN TO ZFRO 


9 


310 


5122000321 ♦ 


LOQf» 


SA2 


TABLE*B2 


GET NEXT MEMORY ADDRESS 


10 




66221 




SB2 


82*81 


INCREMENT THE ADDRESS COUMTER 


11 




36121 




I XI 


X2*X1 


ADO NEW NUMBER TO RUHNIttfi SUM 


12 


311 


0523000310 ♦ 




NE 


8 2« B3»LQQP 


LOOP IF ADDRESS CNTR * IB9I 


13 




0100000443 «■ 




R J 


■xcoo 


CONVERT BINARY NUMBER TO DISPLAY CO&P 


14 


312 


5160000331 ♦ 




S 46 


ANS 


STORE THE DISPLAY CCIDED MUNIIPB IM IMS 


15 




6160000327 ♦ 




WRITEH 


OUTPUT, WORDS 


1»LEN WRITES TO THE OUTPUT BUFFER 


16 


315 


7120000301 ♦ 




WR ITER 


OUTPUT 


PRINTS CONTENTS OF OUTPUT BUPFPR 


17 


317 


7160247021 




EHORUN 




END OF EXECUTABLE CODE 


18 


321 


000 00000000 0000000 01 


TABLE 


DATA 


1 




19 


322 


00000000000000000002 




DATA 


2 


THESE ARE 


20 


323 


00000000000000000003 




DATA 


3 


THE NUMBERS 


21 


324 


00000000000000000004 




DATA 


4 


TO TOTAL. 


22 


325 


00000000000000000005 




DATA 


5 




23 


326 


00000000000000000006 


• 


DATA 


6 




24 


327 


5524100555011'>23?705 


W vj ^ w J 


DATA 


H* THE ANSWER IS ♦ 


25 


331 


1 


kHS 


BSS 


1 




26 






LEN 


EOU 


♦-WORDS 








Octal Code 


♦ ACCESS 


; TO EXTERNAL TEXT. 








Assembled 








TO DEFINE SYSTEM SYMBOLS 


27 






SST 




28 


332 




RNCPL 


XTEXT 


COHCSYS 




29 


372 




RMCn 


XTEXT 


COMCWTH 




30 


425 




RNCPL 


XTEXT 


COHCCIO 




31 


440 




RNCPL 


XTEXT 


COHCCOO 




32 


452 






END 


BEGIN 


END OF PROGRAM 



Octal Location 51200B CM STORAGE USED 443 STATEMENTS 78 SYMBOLS 

Addresses 7600-TYPE CPU ASSEMBLY 0,216 SECONDS 25 tEfCRENCfS 

Oi 

O — — — — — mmm m. 

«c 

g 33 THE ANSWER IS 21 

o 
o 

^ Figure D-1. Example COMPASS Program 



I 



One of the main considerations in assembly language programming is the reduction of execution time. Tne 
instruction repertoire of COMPASS often allows an operation to be coded in several ways. The 
programmer, therefore, should give careful consideration to the instructions used in the program to 
f perform specific functions. 

• Line 1. The IDENT pseudo instruction is always the first instruction in a program. It specifies a 
i program name (EXAMPLE, in this case) to identify the program to the assembler. 

• Line 2. The ENTRY pseudo instruction declares the point in the program at which execution is to 
^ begin. The main entry point in a program is the control transfer address. 

• Line 3. The BSS instruction establishes the output buffer OBUF. The programmer has allocated 
301 3 words of storage for the buffer, as shown in the assembled octal code listed to the left of the 

I source code. Note that the octal code format for the pseudo instructions will differ from the format 

for the symbolic machine instructions because pseudo instructions do not have single machine 
instruction equivalents. 

I • Line 4. The operating system macro FILEC is called to create a file environment table (FET) for the 

output buffer. Only the first word of the FET is shown in the octal code, but examination of the 
location addresses reveals that the table is actually five words in length (the minimum length of a 

I FET). For more information about FETs, see the appropriate operating system reference manual. 

« Line 5. The first executable line of code has been designated the main entry point for the program. 
Incrementing by one occurs so often within a program that it has become a COMPASS coding 
i convention for register Bl to always be initialized to one, and to remain one throughout the entire 

program. This is particularly important during the use of the common common decks (chapter 12), and 
can be a factor in execution time (see Bl=l pseudo instruction) as well as in assembly time. 

m Line 6. A counter is initialized to zero by setting the contents of a B register (chapter 8) equal to the 
contents of the BO register. BO is hard-wired to zero, thereby avoiding the need for repeated 
processing of the literal or constant zero. 

o Line 7. Comparing the octal code for lines 6 and 7, the programmer can see the difference between 
two forms of register-setting instructions. The 15-bit form of the instruction is used in line 6, where 
, only three bits are required to represent the BO register as the source of an operand. The 30-bit form 

of set B register instruction is required for line 7, where the constant 6 is represented by the lower 18 
bits of the instruction. 

I # Line 8. The mask instruction is normally used to extract fields from a register. Here, it is used 

instead of the slower set X register instruction to initialize an X register. 

J Another important feature of COMPASS is illustrated here. The octal code seems to indicate that the 

lower 15 bits of the current word in memory have been left blank. This is the result of a force upper. 
The next instruction is too large to fit in the remaining 15-bit parcel, so COMPASS packs that parcel 
with a no-operation instruction. The next instruction is placed at the beginning of the next word (see 

I section 8.1). 

• Line 9. The use of the set A register instruction to obtain a word of data is demonstrated here. As 
^ seen in the octal code, the address of the word (3213) is placed in the specified A register. The data 

Itself is placed in the corresponding X register (X2 in this instance). (See section 8.4.45.) 

The plus sign (+) after the octal code indicates that the address or K portion of the instruction (the 
I lower 18 bits in this ease) is relocatable. 

• Line 10. The 15-bit format of the set B instruction is illustrated here. The first six bits contain the 
^ operation code for the instruction (663 in this instance). The next three bits designate the 

destination register (B2) for the results of the instruction. The next three bits indicate the register 
containing the first source operand (B2). The final three bits indicate the source register for the 
second source operand (Bl). 
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® Line 11. The number obtained in the previous instruction is added to the running sum kept in XI. This 
is a 60-bit add instruction, as opposed to the SXi instruction, which adds only 18-bit operands. 

• Line 12. The NE instruction shows another use of the B registers in testing for a conditional branch. 
In each iteration of the loop, the source operands are compared. While they are unequal, control is 
transf erred from this instruction back to LOOP. When the operands become equal, control passes to 
the next instruction. 

9 Line 13. The return jump (RJ) instruction is used here to access a common common deck, 

COMCCDD, as a relocatable subroutine. The programmer has taken advantage of the COMPASS 
default method of defining external symbols. The =X indicates to the assembler that CDD, the entry 
point to the subroutine, is external to EXAMPLE. 

The use of common common decks is important to the programmer. Note that the decks require 
certain entry conditions. Specific arguments are expected to be in certain registers, for example, 
upon entry to the routines. An efficient program will establish these conditions with a minimum of 
data transfers by using the registers judiciously prior to the call. COMCCDD, for example, converts 
an octal word to decimal display code; that word is expected to be in register XI. For this reason, the 
running total has been kept in XI, avoiding the need for extra data transfers. 

• Line 14. The method of storing an operand in memory is illustrated here. Setting register A6 or A7 
to a valid address causes the contents of X6 or X7, respectively, to be stored in the address specified. 
When COMCCDD has converted the word, it places the result in register X6, ready for storage upon 
return to the calling routine. 

• Line 15. Another method of accessing a common common deck is shown here. A call is made to a 
system macro, WRITEH, which utilizes the common common deck COMCWTH to write a line from a 
working buffer to an output buffer. 

m Line 16. A call is made to the operating system macro WRITER to write the contents of the buffer 
OBUF (with which the system communicates through the FET OUTPUT) to the system default output 
file, also named OUTPUT. (For more information about operating system macros, see the appropriate 
operating system reference manual.) 

• Line 17. Another operating system macro, ENDRUN, is called to terminate program execution. 

• Lines 18 through 23. DATA pseudo instructions are used here to establish a table comprising six 
consecutive words in memory, starting at location TABLE. The default base mode is base 10 in 
COMPASS (see section 4.4.1). 

« Line 24. DATA is used here to set in memory a display-coded image of the characters specified, for 
use in the output Une. Ten 6-bit characters can be stored per word in this fashion. Therefore, more 
than one word is required here, as seen from the location address on the next line. 

• Line 25. One word of memory is reserved for the final sum. This word is labeled ANS. Note that this 
word is not initialized by the ESS instruction. 

• Line 26. The symbol LEN is equated with the value of the origin counter minus the address of 
WORDS. This yields the length of the output line specified in line 15. 

« Line 27. The SST instruction ensures that symbols from the system texts used by the program are 
defined. 

• Lines 28 through 31. These XTEXT pseudo instructions tell COMPASS to search the system-defined 
program library OPL for the common common decks named. Declarations of this type are normally 
grouped together after the end of the executable code for easy reference. 

o Line 32. The END instruction signifies the end of the program. Control is released through the 
transfer address at BEGIN. 
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The dayf Ue for the program is shown in figure D-2. It shows how the COMPASS program librai'y was 
obtained from a tape with the LABEL command and converted to a random access file via Update. 



ACLA&PO. 80/0'«/l5. ( 22» SVL SN112 NIS. 
OS. 19. ^3.eKAMPLe. 

08,19.^^ . JCCRf 7631, 0.051KC0S. 
OB. 19.43. USER statement. 
03.l9.<i3. statement. 

08. l^.^fS-Cl^iMENr. GtT COMMQS COMMON DECKS FROM C 
08.19.43 .IMP ASS PROGRAM LI8RARY. 

06. l9.43.LA3eL,CPL,Ri 0»HI , F-S I,PO»URM. VSN»0U1066. 
08.24. 10. Mr53» ASSIGNED TO CPl , VSN*0U1066. 

09.24. 10.Ui>3ArE»A,P»CPL»S»RNCPL,L •OUTPUT. 
08.24.29. UPDATE COMPLETE. 

08.24.29. UMLaAO,CPL, 

08. 24. 30. COMPASS (S.S»IPTEXT» S -CP JTF XT, X.RNC PL fOJ 
08.24.31. A>SEM8Lr COMPLETE. 512009 CM USFO. 
08.24.31. 0.237 CPU SECOMOS ASSEMBLY TIME. 

08.24. 31. LGO. 

08.24. 32. UEAO, 0.003KUNS. 
08.2 4. 3 2. JE*F, 0. 041KUNS. 
08.24. 32.UHMT, 1.422KUNS. 
08.24. 32. JEMS, 12.879KUNS. 
08.24, 32. UcCP, 2.031SECS. 
08.24, 32. AESR, 9.912UNTS. 

03.37. 30. UCLP, 7&35, 0.448KLNS. 



Figure n-2. Dayfile of Program EXAMPr>F. 
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DAYFILE MESSAGES 



E 



The dayfile messages that can be issued by COMPASS are listed in table E-1. 

The following message, with xxxxxxx denoting the name of the subprogram being assembled, is displayed at 
the system operator's console only; it is not written to the dayfile. COMPASS updates the display when- 
ever it processes an IDENT statement with a non-blank variable field. 

ASSEMBLING xxxxxxx 
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TABLE E-1. DAYFILE MESSAGES 




ASSEMBLY ABORTED - ECS READ ERROR. 



ASSEMBLY ABORTED - ECS WRITE ERROR. 



ASSEMBLY ABORTED - PASS n TABLE 
OVERFLOW ASSEMBLING xxxxxxx 



Significance 



This message can occur only when 
the Job has an ECS field lei^th and 
is used on a CYBER 170 or CYBER 
70/Model 71, 72, 73, or 74. COM- 
PASS may store some of its inter- 
nal tables in ECS. When an ECS 
error persists through four at- 
tempts to read the data, the mes- 
sage is issued, and the job is 
aborted. For the CYBER 70/ 
Model 76, LCM errors are hand- 
led by the operating system. 

This message can occur only when 
the job has an ECS field length and 
is used on a CYBER 170 or CYBER 
70/Model 71. 72, 73, or 74. COM- 
PASS may store some of its inter- 
nal tables in ECS. When an error 
occurs in writing data to ECS, no 
retry attempt is made. The mes- 
sage is i^ued, and the job is 
aborted. For the CYBER 70/Model 
76, LCM errors are handled by the 
operating system. 

While processing the prc^am indi- 
cated by xxxxxxx, an irrecoverable 
table overflow condition has occur- 
red in assembly pass n (1 or 2). 
COMPASS allocates memory space 
dynamically to all of its internal 
tables. If one table overflows, they 
all do. When the tables do not fit 
in the available SCM space, COM- 
PASS will request additional cen- 
tral memory up to a threshold at 
which time the intermediate file 
and cross-references are dumped 
to mass storage scratch files. If 
table space is still inadequate, 
COMPASS wiU request additional 
central memory up to the maxi- 
mum available to the job. When 
insufficient SCM exists after all 
such possibilities have been ex- 
hausted, COMPASS issues the 
mess^e and aborts the job. 




Rerun job. If con- 
dition persists, con- 
tact a system 
analyst. 



Rerun job. If con- 
dition persists, con- 
tact a system 
analyst. 



Rerun job inserting 
an RFL statement 
s^)ecifying suffi- 
cient field length to 
assemble. 



E-2 
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TABLE E-1. DAYFILE MESSAGES (Cont'd) 



Message 



ASSEMBLY COMPLETE. nnnnnnB |g^j^} USED 



xxxx.xxx CPU 



(seconds assembly time. 

(sec. nnnnnnB {lcm} "^ED 



assembly errors. nnnnnnB |g^j^ I USED. 

xxxx.xxx CPU (seconds ASSEMBLY TIME.) 

(SECnnnnnnB |ECS ^ USED.) 



BAD CONTROL STATEMENT ARGUMENT - xx 



Significance 



If COMPASS did not detect any 
fatal errors during assembly, 
this message is issued at the 
completion of processing of all 
source programs on the input 
file. The minimum field length 
needed to perform the assem- 
blies successfully is the octal 
number of SCM words, nnnnnn. 
If this number ij larger than the 
actual field length, it is the 
minimum field length needed to 
avoid lost references. The 
second line of the message can 
be suppressed by an installation 
parameter; xxxx.xxx represents 
the total central processor time 
used by COMPASS, in seconds to 
three decimal places. If any 
ECS/LCM space was assigned to 
the job, nnnnnn is the octal num- 
ber of words used. 

If COMPASS detected at least 
one fatal error during assembly, 
this message is issued at the 
completion of processing of all 
source programs on the input 
file. If the A option was speci- 
fied on the COMPASS control 
statement, the job is aborted 
after this message is issued. The 
minimum field length need to 
perform the assemblies success- 
fully is the octal number of SCM 
words, nnnnnn. The second line 
of the message can be suppressec! 
by an installation parameter; 
xxxx.xxx represents the total 
central processor time used by 
COMPASS, in seconds to three 
decimal places. If any ECS/LCM 
space was assigned to the job, 
nnnnnn is the octal number of 
words used. 

The COMPASS control state- 
ment contains an unrecognized 
or invalid argument. The 
offending argument is named in 
the message. 



Action 



No action required. 



Correct the fatal 
errors and 
reassemble. 



Refer to chapter 10 
of this manual to 
correct the COM- 
PASS control 
statement. 
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TABLE E-1. DAYFILE MESSAGES (Cont'd) 



Message 


Significance 


Action 


CANT LOAD COMP3$ 


The operating system loader 
reported a fatal error when 
COMPASS attempted to load its 
primary overlay. This message 
should be preceded by an explan- 
atory message from the loader. 


Refer to the loader 
diagnostics in the 
loader reference 
manual for informa- 
tion about the 
specific loader 
error. 


COMPASS NEEDS AT LEAST nnnnnB SCM. 


The SCM field length for the 
job is too small for COMPASS. 

J. 1 It liUIIitJCi Wl v/Clcli WfJl 

needed by COMPASS before it 
can begin processing is nnnnnn. 
This number varies depending on 
the version of COMPASS used 
and the listing and binary out- 
put options specified on the 

control <?tfltpmAnt It ic nn aKcrh* 

lute minimum number of words; 
it does not include whatever 
space may be required for 
system text, local macro and 
micro definitions, and so forth. 


Rerun job inserting 
an RFL statement 
specifying suffi- 
cient field length. 


nnnnnnnnn ERRORS IN xxxxxxx 


COMPASS issues this message 
for each source program in 
which fatal errors are detected; 
nnnnnnnnn is the number of 
errors, and xxxxxxx is the sub- 
program name. 


Correct the fatal 
errors and 
reassemble. 


FILE USE CONTRADICTION. 


Control statement specifies 
the same file name for two or 
more of the following: 

Source input 

- List output (full or short 
list) 

- Binary output 
~ A I r.A I source 


Correct contra- 
diction. 


IDENT STATEMENT MISSING. 


COMPASS issues this message 
for each source program in 
which an END statement is en- 
countered before an IDENT 
statement is found. This is a 
fatal error. 


Correct the source 
program to include 
an IDENT and END 
statement for each 
subprogram. 


IMPROPER SYSTEM TEXT FORMAT. 
BAD SYSTEM TEXT - x=yyyyyyy/zzzzzzz 


A system text overlay does not 
have the internal format 
required by this version of 
COMPASS. This may be caused 


Correct the inter- 
nal format of the 
system text 
overlay. 
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TABLE E-1. DAYFILE MESSAGES (Cont'd) 



Message 



INPUT FILE EMPTY OR MISPOSITIONED. 



INSUFFICIENT STORAGE FOR SYSTEM TEXT. 
BAD SYSTEM TEXT - x=yyyyyyy/zzzzzzz 



nnnnnnnnn LOST REFERENCES IN xxxxxxx 



MORE THAN 7 SYSTEM TEXTS SPECIFIED. 



N PARAMETER OBSOLETE, IGNORED. 



Significance 

by a system error. COMPASS 
ignores the bad overlay but does 
not abort the job. The expres- 
sion, x=yyyyyyy/zzzzzzz, iden- 
tifies the offending overlay in 
the same form in which it is 
specified in the COMPASS con- 
trol statement; it may be any of 
the following: 

- G=filenam 

- G=filenam/overlay 

- S=overlay 

~ S=library/overlay 

When attempting to read the 
first line from the source input 
file, COMPASS encountered end 
of data and aborted. 

When an irrecoverable table 
overflow occurs, COMPASS 
issues this message before 
the first assembly is begun. It 
does not abort the job. The 
expression, x=y yy y yy y /zzzzzzz , 
identifies the system text being 
loaded at the time. 

The symbolic cross-reference 
table is sorted before it is 
printed. If the table does not fit 
in the job's SCM field length 
for sorting, COMPASS discards 
some of the references. A 
message is issued; nnnnnnnnn is 
the number of references 
discarded, and xxxxxxx is the 
subprogram name. The job is not 
aborted. The ASSEMBLY COM- 
PLETE message gives the field 
length needed to avoid lost 
references. 

COMPASS issues this message 
and aborts the job, when the G 
and S parameters on the COM- 
PASS control statement specify 
a total of more than seven 
system text overlays. 

The N parameter has been 
obsoleted by the BL parameter. 




Correct the name 
of the source input 
file or reposition 
the file. 

Increase the SCM 
field length for the 
job. 



Increase the SCM 
field length for the 
job. 



Restructure the job 
to reduce the num- 
ber of system text 
overlays required. 



Remove the N 
parameter from 
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TABLE E-1. DAYFILE MESSAGES (Cont'd) 



Message 


Significance 


Action 






the control state- 
ment. 


NO CONTROL STATEMENT TERMINATOR. 


Before finding a parenthesis or 
period not in a $-delimited 
string, COMPASS read continua- 
tion control statements and 
encountered an end-of-section. 
This is not a fatal error. 


Correct the con- 
trol statement. 


RECURSION DEPTH EXCEEDED 400. 


COMPASS maintains a push- 
down stack for source input con- 
trol. This stack has one entry 
for each active DUP, ECHO, 
HERE, XTEXT, or macro call. 
The maximum depth of the 
stack is set by an installation 
parameter; it is 400 in the 
released system. When this 
limit is exceeded, COMPASS 
sets a fatal error and clears the 
stack. The next statement can 
then be read from the source 
input file. The job is not aborted. 
This error is usually caused by a 
source program in which a 
macro calls itself indefinitely. 


Correct the macro 
call program error. 


SYSTEM TEXT NOT FOUND. 
BAD SYSTEM TEXT - x=yyyyyyy/zzzzzzz 


When it cannot load the system 
text overlay identified by 
x=yyyyyyy/zzzzzzz, compass 
issues this message. It does not 
abort the job. For an overlay 
loaded from a library file (S 
parameter), this message 
should be preceded by an 
explanatory message from the 
operating system loader. For an 
overlay loaded from a non- 
library file (G parameter), 
COMPASS could not find the 
overlay on the file. 


For an overlay 
loaded from a 
library file, refer 
to the diagnostics 
in the loader refer- 
ence manual. For 
an overlay loaded 
from a non-library 
file, check that the 
overlay name is 
specified correctly 
and that the over- 
lay is located on 
the file. 


nnnnnnnnn WARNING MESSAGES IN xxxxxxx 


COMPASS issues this message 
for each source program in 
which nonfatal errors are de- 
tected; nnnnnnnnn is the number 
of errors, and xxxxxxx is the 
subprogram name. 


Correct the non- 
fatal errors and re- 
assemble. 
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GLOSSARY 



ABSOLUTE BLOCK - 



ASSEMBLER - 



A block of object code generated in an absolute assembly, 
instruction is used to declare a program absolute. 



The ABS pseudo 



A computer language that prepares an executable program from a source 
language program by substituting machine operation codes for symbolic operation 
codes and absolute or relocatable addresses for symbolic addresses, 

BLANK COMMON BLOCK - 

A common block Into which no data is stored at load time. The first declaration 
of a blank common block need not be the largest declaration for the common 
block. 

BLOCK - A grouping of words of object code or storage within a subprogram for a 

specific purpose. 

CAPSULE - A relocatable collection of one or more programs bound together in a special 

format that allows the programs to be loaded and unloaded dynamically to form 
an executing program by the Fast Dynamic Loading facility. 

CENTRAL PROCESSOR UNIT (CPU) - 

The high-speed arithmetic unit that performs the addition, subtraction, 
multiplication, division, incrementing, logical operations, and branching 
instructions needed to execute programs. 



COMMENT LINE - 



COMMENTS FIELD - 



A statement providing documentary information for a section of code. Comment 
lines are indicated by either an asterisk in column 1 or blanks in columns 1 
through 29, and are listed but not otherwise processed by the assembler. 

The field in a COMPASS statement providing documentary information for the 
statement. It is listed but not otiierwise processed by the assembler. This 
field begins with the first nonblank character following the variable field, or 
in column 30 if the variable field is blank. 



CQMMON BLOCK 



CONSTANT - 



DATA ITEM - 



An area of memory that can be declared by more than one subprogram and used 
for storage of shared data. 

An expression element consisting of a value represented in octal, decimal 
hexadecimal, or character notation. 

A type of character or numeric value that can be used in subfields of the DATA 
and LIT instructions, and as specifications of field lengths on VFD pseudo 
instructions. 



ENTRY POINT - 



A location within a subprogram that can be referenced from other subprograms. 
Each entry point has a name with which it is associated. 



EXTERNAL REFERENCE - 

A reference in one subprogram to an entry point in another subprogram. 



FORCE UPPER - 



To guarantee that an instruction begins on a word boundary by packing the 
parcels remaining in a partially completed word with no-op instructions and 
beginning to assemble the specified instruction in the next word. The assembler 



I 
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automatically forces upper in some cases, and the user program can specify 
that a given instruction be forced upper. 



LABELED COMMON BLOCK - 

A common block into which data can be stored at load tl me. The first prc^ram 
declaring a labeled commcai block determines the amount of memory allocated. 



LINKING - 
LITERAL - 

LITERALS BLOCK 
LOAD SEQUENCE - 

LOCAL BLOCK - 



The process of matching external references to entry points of the same names 
and inserting the addresses of the entry points Into the external references. 

A read-only constant. Conventionally, it is the only element in an expression. 
Literals are stored in the program's literals block to avoid duplication of 
read-only data. 

A block of literal data entries local to a subprogram. 

One or more consecutive control statements processed by the loader as a 
unit. A load sequence can be a single name call statement, or it can consist 
of loader statements (such as LOAD and LDSET) that are terminated by NOGO, 
EXECUTE, or a name call statement. 

A storage area defined by a USE or USELCM pseudo instruction. 



LOCATION COUNTER - Normally the same as the origin counter. Can be reset by the programmer to 

relocate code or data without affecting relative positions within the block. 



LOCATION FIELD 



The first field in a COMPASS statement, usually providing a name for the 
address of the instruction or for the entity defined by the statement. The 
location field begins in column 1 or 2. 



MACHINE INSTRUCTION - 

A string of bits capable of being interpreted directly by a central processor 
or peripheral processor as an instruction to perform some operation. 



MACRO 



MICRO - 



OPDEF - 



OPERATION CODE 



OPERATION FIELD - 



ORIGIN COUNTER - 



A sequence of source statements that are saved and then assembled whenever 
needed through a macro call. 

A character string identified by a symbolic name. Wherever the name is 
encountered in the program, the character string is substituted. 

A sequence of source statements that are saved and then assembled whenever 
needed through an opdef call. Differs from a macro in that the assembler 
interprets the call by examining the format or syntax of the instruction rather 
than the contents of the operation field alcaie. 

A mnemonic operator, used in the operator field of a COMPASS statement, 
to indicate a specific machine instruction. 

The field in a COMPASS statement indicating the operation to be performed. It 
begins with the first nonblank character following the location field; or, if the 
location field is blank, it begins with the first nonblank character after column 
2. 

A pointer indicating the relative location of the next word to be assembled or 
reserved in a given block. 
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OVERLAY - One or more relocatable programs that were relocated and linked together Into 

a single absolute program. 

PARCEL - Ofis of the 15-bit sections of a central memory word. A CPU machine instruc- 

tion occupies one, two, or four parcels. 

PERIPHEKAL PROCESSOR UNIT (PPU) - 

An individual computer with its own memory, used for high-speed transfer of 
information (input and output) between peripheral devices and central memory. 

POSITION COUNTER - 

A pointer indicating the bit position within the word of the next item to be 
assembled in a given bloclc. 

PROGRAM - One or more subprograms capable of being executed as a unit. 

PSEUDO INSTRUCTION - 

An assembler-defined instruction appearing in the operation field of a statement. 
It normally does not specify the assembly of a single machine instruction, but 
instead specifies some other assembly process (such as symbol definition, 
listing control, and so forth. ) 

QUALIFIED SYMBOL - A symbol defined when a qualifier is in effect during assembly. Through 

qualification, the same symbol can be referred to in different subprograms 
without conflict. 

REFERENCE ADDRESS (RA) - 

The first word in the field length of a job. Because of dynamic relocation, the 
RA frequently changes with respect to the first word in central memory; but it 
always remains the same with respect to other addresses within the Job's 
field length. 

REGISTER - A unit within the central processor used to hold operands. The A registers 

contain the addresses of words within central memory; the X registers contain 
operands used in calculations; the B registers are used for incrementing and 
indexing. 

RELOCATION - Placement of object code into central memory in locations that are not pre- 

determined, and adjusting the addresses accordingly. 

REMOTE ASSEMBLY - An operation in which code is assembled, saved, and then inserted into the 

object code when specified. 

STRONG EXTERNAL - An external reference whose satisfaction is obligatory for program loading. 

SUBPROGRAM - A group of COMPASS statements beginning with an IDENT pseudo instruction 

and ending with an END pseudo instruction. 

SYMBOL - A set of characters that identifies a value and its associated attributes. 

SYSTEM TEXT - A set of tables containing symbol, micro, macro, and opdef definitions that 

can be saved on a file to be accessed by other programs. 

TRANSFER ADDRESS - The address of the entry point to which the loader jumps to begin program 

execution. 
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VARIABLE FIELD - 



WEAK EXTERNAL - 



ZERO BLOCK - 



The field in a COMPASS statement identifying operands for the statement. It 
consists of one or more subflelds, and begins with the first nonblank character 
after the operation field. 

An external reference that is ignored by the loader during library searching 
and cannot cause any other program to be loaded. A weak external is linked, 
however, if the corresponding entry point is loaded for any other reason. 

The nominal central memory block for a relocatable assembly. It is local to 
a sub-program. Also, a zero block is created for an absolute assembly if 
default symbols are used. 
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A abort mode 10-2 

A code option 4-24 

A error 11-9 

A list option 4-72 

A reference table option 4-78 

A register 

description 8-7 

designators 2-8 

setting 8-44 
ABS attribute 4-()4 
ABS pseudo 

description 4-G 

example 4-4, 7, 13, 14, 16, 17,44 

first statement group 4-2 
Absolute block 

absolute program 3~() 

description 3-2 

establishment 4-30 

relocatable program 3-5 

using 4-30,31 
Absolute program 

declaration 4-G 

structure 3-6 
Absolute text 3-5 
ACN instruction 9-21 

ADC instruction 

arithmetic function 9-4 

description 9-9 

example 2-20,9-9 
ADD instruction 

arithmetic function 9-4 

description 9-12 
Add unit 

floatingpoint 8-3,6,37 

long 8-3,8-39 
Address modes, PPU 9-1 
Address 

absolute 4-4 

direct 9-12 

entry point 4-4, 5, 43 

external 4-6,9,45 

indexed 9-14 

indirect 9-13 
ADl instruction 

arithmetic function 9-4 

description 9-13 
ADM instruction 

arithmetic function 9-4 

description 9-15 
ADN instruction 

arithmetic function 9-4 

description 9-8 
AJM instruction 9-17 



AOD instruction 

description 9-12 

replace function 9-5 
AOI instruction 

description 9-13 

replace function 9-5 
AOM instruction 

description 9-15 

replace function 9-5 
Arithmetic functions, PPU 9-4 
Arithmetic shift 8-32 
Arrow 

parameter separator 5-8, 13 

special character 2-4 
ASCII code 

character set A-1 

option 4-25 
Assembler 1-1 

central memory requirements 1-3; 10-1 

statistics 4-71; 11-8 
Assembly environment test 4-58 
Assembly listing 

detailed description 11-1 

general description 4-71 

generatim 1-3 
Assembly, remote code 5-3 
Assembly time 11-8 
Asterisk 

BASE instruction 4-23 

element operator 2-22 

first column 2-1, 2 

local symbol separator 5-31 

locatiCTi counter 2-9; 3-4 

parameter separator 5-8, 13, 16, 24, 28 

special element 2-9, 32; 3-4 

USE instruction 4-30 

USELCM instruction 4-32 
Attribute, symbol 2-5 
Attribute test 4-64 
AXi instructicai 8-30,32 

B base 2-17, 18;4-22 

B binary mode 10-2 

B list c^>tion 4-72 

B reference table option 4-78 

Bl=l or B7--1 pseudo instructicai 

description 4-28 

effect on R= 4-53 

example 4-54 

ill^al for PPU 4-9,10 
B register 

conditional jumps 8-23 

contents of 4-28 

description 8-7 
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designators 2-8 
setting 8-46 
Base, assembly 4-22.1 

COL column count 4-29 
DIS word count 4-47 
DUP count 5-6 
ECHO count 5-7 

line count 4-58, 59, 61, 62, 65, 67, 68 

micro count 7-2,4 

numeric value 2-16 

overlay level numbers 4-4 

PPU number 4-4 

REP counts 4-55 

setting through BASE 4-22.2 

SPACE line count 4-74 

string count 2-13 

VFD count 4-51 
BASE micro 7-6 
BASE pseudo 

description 4-22.2 

example 4-13, 19, 23, 47, 49 

permissible anyvrhere 4-2 
Binary control statements 4-1, 72; 11-1 
Binary load module 3-8 
Binary mode 10-2 

Binary outfHit generation 1-3; 3-7, 9, 11, 13; 10-2 

Binary write 3-8 

Blank 

compressed 5-1 

embedded 2-1 

expression terminator 2-1 

name terminator 2-5 

operation field 2-1 

parameter separator 5-8, 13 

statement terminator 2-1 

siring terminator 2-14 

use in character data 2-14 

variable field 2-2, 3; 3-8 
Blaniv card 4-74 
Blank common 

CM 4-30 

description 3-3 

ECS 4-32 

esLiblishment 4-30,32 

example 4-36 

LCM 4-32 

SCM 4-30 
lilank fill 2-14 

DIS 4-47 
Blank operation field 4-45 
Block copy instruction 8-13 
Block group 3-1, 12, 14 
Block group listing 11-2 
Block 

absolute 3-1; 4-32, 36 

blank common 3-3; 4-32, 34 

laljeled common 3-2; 4-30 

literals 2-11; 3-2, 3-5 thru 15 

local 3-2; 4-30 

maximum number 3-1; 4-30 

origin assigned 1-2; 3-5, 7 

subprogram 3-1 

used for definition operation 5-2 

user ostablisiied 3-2; 4-30,32 

zero 3-2; 4-30,32 



Block name 3-3; 4-30, 32 
Block name listed 11-1 
Block origin 1-2; 3-5 
Block usage summffl-y 11-2 
Boolean unit 

description 8-3, 6 

instructions 8-25, 26, 27, 28, 29, 34, 35, 36 
Branch instructions 

CPU 8-10,11,14,20,23 

PPU 9-5 
Branch unit 

description 8-3 

instructions 8-10,11,14,20,21,23 
BSS pseudo 

description 4-35 

effect on origin counter 3-3 

example 4-4, 7, 10, 16, 28, 33, 36, 37, 40, 44; 
5-22, 32 

force upper 3-4 
BSSZ pseudo 

description 4-46 

dumped by SEGMENT 4-16 

example 2-19; 5-33, 35 

force upper 3-4 
BXi instruction 8-25 thru 8-28 
Byte, guaranteed zero 2-14; 4-48 

C hardware feature code 4-8 

C list option 4-72 

C on octal listing 11-6 

Call 

equivalenced macro 5-25 

macro 5-18 

opdef 5-29 
CO instruction 8-53 
Central memory requirements 1-3, 10-1 
Central processor unit 

functional units 8-3, 6 

instructions 8-1 

registers 8-7 
Channel buffer instruction 

read status 8-19 

reset input 8-17 

reset output 8-18 
CHAR 

define other character 4-24 
Character codes A-1 
Character data 2-13 

code conversion 4-24 

evaluation 2-27 

examples 2-12, 15 
CMU 8-50 
Code 

CPU operation 6-7; 8-1 

duplication 5-6 

Code other 4-24 

PPU operation 6-3; 9-1 

remote assembly 5-3 

replication 4-55 
CODE micro 7-6 
CODE pseudo 

description 4-24 

effect on character data 2-13; 4-47 
example 4-25 
permissible anywhere 4-2 
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Coding form 2-3 
COL pseudo 

description 4-9 

octal listing 11-6 
Column one 2-1 
COM attribute 4-64 
Comma 

character string 2-13 

column me 2-1 

continuation 2-1 

expression terminator 2-21 

local symbol separator 5-31 

name terminator 2-5 

parameter separator 5-8, 13, 16, 24, 28 

string terminator 2-13 

subfield delimiter 2-1 
COMMENT pseudo 

description 4-20 

example 4-13 

first statement group 4-2 
Comments column control 4-29 
Commmts field 2-2, 3; 4-29 
Comments statement 2-2 

heading of definition 5-13 

micros not substituted 7-1 

not ccMinted 4-57; 5-7,8 

permissible anywhere 4-2 
Comments, prefix table 4-20 
Common common decks 

COMCARG 12-3 

COMCCDD 12-3 
I COMCCFD 12-4 

COMCCRD 12-4 

COMCCIO 12-4 

COMCCOD 12-5 

COMCCPT 12-5 

COMCDXB 12-6 

COMCMNS 12-6 

COMCMOS 12-7 

COMCMTM 12-8 

COMCMTB 12-9 

COMCMVE 12-13 

COMCRDC 12-13 

COMCRDH 12-14 

COMCRDO 12-14 

COMCRDS 12-15 

COMCRDW 12-16 

COMCRSR 12-16 

COMCSFN 12-17 

COMCSRT 12-17 

COMCSST 12-17 

COMCSTF 12-19 

COMCSVR 12-19 

COMCSYS 12-19 

COMCUPC 12-21 

COMCWOD 12-22 

COMCWTC 12-22 

COMCWTH 12-22 

COMCWTC 12-23 

COMCWTS 12-23 

COMCWTW 12-24 

COMCX.JR 12-25 

COMCZTB 12-25 



Compare character strings 4-66 
Compare expresslai values 4-60 
Compare/Move unit 8-50 
COMPASS call statement 

description 10-2 

effect on LIST 4-77 
Compile file 10- 4 

Comp and log difference instructim 8-30 
Comp and log sum instructioQ 8-30 
Complemaat Instructicai 8-29 
Compressed code 5-1 
CON pseudo 

description 4-52 

example 2-22; 4-53; 5-5, 23, 26 

force upper 3-4 
Concateiation 2-4 
Concatenation mark 2-4 

example of use 5-19 

in definition 5-1 
Condititmal assembly 4-57 
Conditional jump 

B register 8-23 

FPU 9-5 

X register 8-21 
Conflguration 1-3 
Constant 

character 2-14 

description 2-10 

express icm element 2-21,26 

field size 2-11 

generated by pseudo 4-52 

numeric 2-16 

read only 2-11 
Continuation, statement 2-2 

generation of lines 2-4; 7-1 
Control statements 

COMPASS 10-2 

job statement 10-1 

Counters, block control 3-3, 10, 12 
Counter control 

BSS 4-35 

forcing upper 3-4 

LOC 4-36 

ORG 4-33 

ORGC 4-33 

POS 4-38 

USE 4-30 

USELCM 4-32 
CPOP pseudo 6-7 
CPSYN pseudo 

description 6-10 

permissible anywhere 4-2 
CPU instructions 

block copy 8-13 

Boolean 8-25 thru 28, 34, 35, 36 

branching 8-21, 26 

channel buffer 8-17, 18 

chaimel status 8-19 

complement 8-28,29 

conditional 8-21,23 

direct LCM transfer 8-16 

divide 8-42 

double precision 8-37,40 
ECS 8-12 
error exit 8-11 
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exchange exit 8-15 
exchange jump, 6000 8-14 
fixed point 8-38 

floatingpoint 8-33,36,37,39,40,42 
I increment 8-44, 46, 48 

left shift 8-30, 31 
i logical 8-26 thru 31 

long add 8-38 

mask 8-41 

multiply 8-39, 40 

I no operation 8-43 
normalize 8-33 
pack 8-35 
pass 8-43 
i population 8-44 

program stop 8-10 
real-time clock 8-18 
return jump 8-11 
_ right shift 8-30, 32 
I set register 8-44, 46, 48 
set time 8-18 
shift 8-30 thru 33 
single precision 8-36 
transmit 8-25 
unconditional jump 8-20 
I unpack 8-34 

CPU program executicai 1-3; IQ-I 
CPU register designators 2-8; 8-7 
CRD instruction 9-16 
Created symbol 5-31; 11-8 
CRM instruction 9-16 
Cross reference table 

(see symbolic reference table) 
- CTEXTpseudo 4-77 
1 CU instruction 8-54 

CWD iretruction 9-16 
„ CWM instruction 9-16 
i CXi instruction 8-44 

D base 2-17; 4-22.2 
D code option 4-24 
D debug mode 10-3 
D definition flag 11-14 
D error 11-10 

D hardware feature code 4-7 
D list option 4-72 
Data generation 4-45 
Data item 

character format 2-13 

DATA pseudo 4-47 

general descriptim 2-10 

LIT pseudo 4-49 

numeric format 2-17 

VFD pseudo 4-51 
Data notation 

character 2-13 

constant 2-10,13,16 

decimal 2-17 

element 2-10,21 

fixed point 2-17 

floating point 2-17 

hexadecimal 2-21 

item 2-10,13,16 

literal 2-11, 13, 16 

numeric 2-16 



octal 2-17 
DATA pseudo 

description 4-46 

example 2-15, 19, 20; 4-25, 31, 35, 47 
force upper 3-4 
Data transmission, PPU 9-3 
DATE micro 7-5 
Date of listing 11-1 
DON instruction 9-21 
I>et>ug, interactive 1-4 
Debug mode 10-3 
Decimal exponent 2-17 
Decimal notation 2-17 
DECMIC pseudo 

description 7-4 
example 5-6; 7-4 
permissible anywhere 4-2 
DEF attribute 4-65 
Default symbols 
definition 2-7 
listing 11-9 
unqualified 4-25 
zero block 3-2 
Deferred symbols 

(see default symbols) 
Definition 

equivalenced macro 5-24 
macro 5-13, 15, 24 
micro 7-2 
opdef 5-13,27 
processing 5-13 
purging 6-9 
reference 5-18,25,30 
symbol 2-6; 4-42 
system 5-35 
Definition operation 

duplicated code 5-6 
equivalenced macro 5-13 
external text 5-2 
macro 5-13 
operation code 5-13 
processing 5-14 
recursion level 5-1 
remote text 5-3 
Delimiter 

actual parameter 5-18,26 
data item 2 -15, 16 
expression element 2-21 
field 2-1,2 

substitutable parameter 5-8, 13 16 

term 2-22 ' 
Descriptor, variable field 5-27 
Destination field 2-26 
Detailed listing 4-72; ll-i 
DF instructicHi 8-23 
Direct address 9-12 
Directives, loader 4-21 
Directory, error 11-9 
DIS pseudo 

description 4-47 

example 4-47,49 

force upper 3-4 
Display code option 

character set A-l 

default mode 2-13 

option 4-24 
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Divide instructions 8-42 
i DM instructioQ 8-52 
I>>llar sign 

local symbol separator 5-31 

parameter separator 5-8, 13, 16, 24, 28 

special element 2-5 
Double precision instructions 8-36, 37, 40 
DU P pseudo 

description 5-6 

example 5-10, 11 

listing of count 11-6 
Duplication 

code 5-6 

echoed 5-7 

indefinite 5-7,9 
DXi instructions 

add 8-37 

multiply 8-40 

E code option 4-25 
i E entry point flag 11-14 
E error 11-10 
E list (^ticHi 4-72 
E numeric data modifier 2-17 
ECHO pseudo 

description 5-7 

example 5-12 
ECS blocks 4-32 
Editing 2-4 

EE numeric data modifier 2-17 
EIM instruction 9-18 
EJECT pseudo 4-74 

permissible anywhere 4-2 
Eject suppression 10-4 
EJM instruction 9-17 
Element 

absolute 2-23 

data 2-10 

expression 2-21,26 
external 2-24 
operator 2-22 
register 2-25 
relocatable 2-9, 24 
special 2-9,21 
ELSE pseudo 

description 4-58 
example 5-5 

permissible anywhere 4-2 
END pseudo 

assembly of remote code 5-3 
binary generation 3-6 
desCTiption 4-4 
i effect on blocks 3-1, 6, 8, 10, 12 
example 4-4; 5-7, 13, 14, 16 
external text use 5-3 
force upper 3-4 
illegal definitions 5-1 
permissible anywhere 4-2 
ENDD pseudo 

acting as nil 6-6 
description 5-10 
example 5-11 
permissible anywhere 4-2 
used with DUP 5-7 
used with ECHO 5-8 



ENDIF pseudo 

acting as nil 6-6 

description 4-57 

permissible anywhere 4-2 
EN DM pseudo 

acting as nil 6-6 

description 5-14 

example 4-29; 5-11, 15, 19, 20, 21 

permissible anywhere 4-2 
End-of-line mark 5-1 
ENDX pseudo 4-77 
Entry address 

absolute 4-3 

declaration 4-43 

multiple 3-12 

relocatable 4-4 
ENTRY pseudo 

description 4-43 

example 4-5,44 
ENTRYC pseudo 4-43 
Entry point list U-4 
Environment test 4-58 
EOM instructim 9-18 
EQ instruction 

description 8-24 

example 8-25 
force upper 3-4 
EQ IF operator 4-60 

IFC operator 4-66 
EQU pseudo 

description 4-39 

example 2-19, 21; 4-19, 37, 39, 62; 5-6 
listing 11-6 
Equal sign 

default symbol prefix 2-7 

instruction 4-39 

literals prefix 2-11,13,17 

local symbol separator 5-31 

parameter separator 5-8, 13, 16, 25, 28 
ERN instruction 9-12 
ERR pseudo 

description 4-69 
Error, assembly 

fatal 11-9 

informative 11-12 

programmer controller 4-69, 70 
Error directory 

detailed description 11-9 

general description 4-71 
Error exit instruction 8-11 
Error flags 

conditionally set 4-69 

fatal 11-9 

informative 11-12 

unconditionally set 4-70 

where on listing 11-6 
ERRxx pseudo 4-70 
ES instruction 8-11 
ESN instruction 9-22 
ETN instruction 9-12 
Evaluation of expression 2-26 
Exchange exit instruction 8-15 
Exchange jump instructicm 8-14 
Execution, CPU program 1-3 
EXN instruction 9-10 
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Exponent 2-17 
Expression 

absolute 2-23 

attribute 4-64 

comparison 4-60 

CON use 4-52 

description 2-21 

evaluatlcHi 2-21,26; 3-3 

examples 2-24, 25 

external 2-24 

maximum size 2-26 

operators 2-22 

pass one value 2-26; 3-3 

pass two value 2-26; 3-3 

register 2-25; 8-2, 9 

rules 2-22 

size 2-26 

types 2-23 

value 2-23,26; 3-3; 8-5 

VFD 4-51 
EXT attribute 4-64 
External BCD 

character set A-1 

option 4-25 
External symbol 

declaration 4-45 

description 2-5 

strong 2-7 

weak 2-7 
External symbol list 11-4 
External text 

assembly 5-2 

file declaration 10-3 

listing 4-77 
EXT pseudo 

description 4-45 

illegal in absolute code 4-6, 9, 10 

F conditional flag 11-14 
F error 11-10 
F FORTRAN mode 10-3 
F list option 4-72 
FAN instruction 9-21 
Fatal error flag 11-9 
Features of COMPASS 1-2 
Field 

comments 2-2; 4-29 
conventional 2-3 
delimiter 2-1,2 
destination 2-25; 4-51 
free 2-1 

length, threshold 1-3 
location 2-1 
operation 2-1 
size 2-1 
subfield 2-2 
terminator 2-1 
variable 2-2 

File 

COMPILE 10-3 
INPUT 10-3 
LGO 10-2 
list output 10-3 
load and go 10-2 
OLDPC 10-5 
OPL 10-5 
OUTPUT 10-3 



source 10-3 

SYSTEXT 4-17; 10-3,4,5 
System text overlay 10-5 

Fill 

blank 2-14 

zero 2-14 
FIM instruction 9-18 
First column 2-1 
First statement group 4-2 
Fixed point data notation 2-17 
Fixed point Instructions 8-38,40 
FJM instruction 9-17 
Flag, error 

listing 11-6 

setting 4-69 

type 11-14 I 
Floating point data notation 2-16 
Floating point units 8-3, 6 

add 8-36,37 

divide 8-42 

multiply 8-39,40 
FNC Instruction 9-21 
FOM instruction 9-18 
Forcing upper 3-4 

BSS 4-35 

CPU instructions 8-2 

LOC 4-36 

macro call 5-18,25 

opdef call 5-27 

ORG 4-33 

ORGC 4-33 

R= 4-53 

USE 4-30 

USELCM 4-32 

VFD 4-51 
Form, COMPASS coding 2-3 
Format 

control statemmt 10-1 

CPU instructicm 8-12 

line 2-1 

listing 11-1 

PPU instructirai 9-1 
FORTRAN 4-4; 10-3 
Full list 10-3 
Functicxial units 8-3, 6 
Functions, PPU 

arithmetic 9-4 

data transmission 9-3 

logical 9-4 

replace 9-5 
FXl instruction 

add 8-37 

divide 8-42 

multiply 8-39 

G assembly mode 10-3 
G list option 4-72 
GE instructions 8-23 
GE IF qjerator 4-60 

IFC operator 4-66 
Generated code listing 4-72 
Generation, data 4-46 
Get text mode 10-3 
GT instruction 8-23 
GT IF operator 4-67 

IFC operator 4-72 
Guaranteed zero 2-14 4-48 
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Hardware configuration i-3 
Hardware feature dependency 4-7 
Heading 

listing 4-71; 11-1 

macro 5-13 

opdef 5-13 
HERE pseudo 

description 5-4 

permissible anywhere 4-2 
Hexadecimal data 2-21 



I code cation 4-21 

I hardware feature code 4-7 

I input mode 10-3 

I NOLABEL option 4-21 

lAM instruction 9-20 

IAN instruction 9-19 

IBj instruction 8-20 

ID instruction 8-22 

IDENT pseudo 

binary generation 3-8, 9, 10 

blank variable field 3-14; 4-11 

deso-iption 4-2, 11 

example 4-4, 7, 13, 14, 16, 17, 19 

force upper 3-4 

overlay generation 3-8, 9, 10 

program identification 4-2 
IF pseudo 4-63 
IF skipped lines listed 4-72 
IFCPpseudos 4-59 
IFC pseudo 

description 4-66 

example 5-5, 11 

permissible anywhere 4-2 
IFop pseudo 4-60 
IFPP pseudo 4-59 
IFtype pseudo 4-59 
IJM instruction 9-17 
IM instruction 8-51 
Increment unit 8-3, 6, 44, 46, 48 
Indexed address, PPU 9-14 
Index register 8-7 
Indirect address, PPU 9-13 
Input, assembler 10-3 
Instructions 

coding of 2-1 

CMU 8-49 

CPU 8-1 

mnemonically identified 6-3 
nil 6-6 

no-operation 8-43; 9-9 
t PPU 9-1 

pseudo 4-1 

redefinition 5-16, 25 

synonymous 6-5, 10 

syntactically identified 6-7 
Integer add 8-37 
Integer subtract 8-37 
Integer multiply 8-40 
Integer value 2-17 
Interactive debugging 1-4 
Internal BCD 

character set D-1 

option 4-24 
Invented symbol 5-32; 11-8 
IR instruction 8-22 



IRM instruction 9-18 
IRP pseudo 

acting as nil 6-6 

description 5-33 

example 5-34, 35 

permissible anywhere 4-2 
IXi instructions 8-38,40 

J option 4-9, 10; 9-5 
JDATE micro 7-6 
Job statement 10-1 
JP instruction 

description 8-21 

force upper 3-5 

L control statement option 

description 10-3 

related to LIST 4-72 
L error 11- 11 

L hardware feature code 4-8 
L list option 4-72 
L location flag 4-36; 11-14 
Labeled common 

description 3-2 

establishment 4-30. 32 
LCC pseudo 

description 4-21 

illegal if absolute 4-6, 9, 10 
LCM attribute 4-64 
LCM blocks 3-2; 4-32 
LCM transfer instructions 8-13, 16 
LCN instruction 

data transmission 9-3 

description 9-8 
LDC instruction 

data transmission 9-3 

description 9-9 

example 2-20 
LDD instruction 

data transmission 9-3 

description 9-12 
LDI instruction 

data transmission 9-3 

description 9-13 
LDM instruction 

data transmission 9-3 

description 9-15 

example 5-21 
LDN Instruction 

data transmission 9-3 

description 9-8 

example 5-12; 9-8 
LDSET pseudo 

description 4-21 

permissible anywhere 4-2 
Left shift instruction 8-29, 31 
LE IF c^erator 4-60 

IFC operator 4-66 
LE iiistructicffli 8-24 
Library maintenance programs 2-1 
LGO control statement 10-6 
Linkage symbols 2-6; 4-43 
Li stable output 

assembled code 11-5 

assembler statistics 11-8 



60492600 G 



binary control cards 11-1 
block usage 11-2 
control statement 10-3 
default symbols 11-8 
entry point symbols 11-4 
error directory 11-9 
error flags 11-9 thru 12 
external symbnols 11-4 
header infcH*mation 11-1 
literals 11-7 
source statements 11-5 
statistics 11-8 
subtitles 11-1 

symbolic reference table 11-13 
titles 11-1 

user cmtrol 4-77; 10-3, 4 
List, full 10-3 
Listing control 

control statement 10-3,4 

pseudo 4-71 
List, parameter 

ECHO 5-8 

equivalenced macro 5-25 

macro 5-18 
LIST pseudo 

description 4-71 

example 4-13; 5-6, 12 

permissible anywhere 4-2 
List, short 10-4 
Literals 

absolute program 3-6, 7, 10, 11 

d^cription of block 3-1, 2 

IDENT 3-10, 14 

listing 11-7 

location 1-3; 3-1,2 

notation 2-11 

protection 4-33 
SEGMENT overlay 3-10 
SEG partial binary 3-12 
symbol (default) 2-7 
LIT pseudo 

description 4-49 

example 2-12, 17, 21; 4-15, 56; 5-6 

listing 11-6,7 
LJM instruction 

description 9-6 

example 5-21 
LMC instruction 

description 9-9 

logical function 9-5 
LMD instruction 

description 9-12 

logical function 9-5 
LMI instruction 

description 9-13 

logical function 9-5 
LMM instruction 

description 9-15 

logical function 9-5 
LMN instruction 

description 9-8 

logical function 9-5 
LO control statement option 10-4 
Load address 4-3 
Load-and-go file 1-3; 10-2 



Loader control statement 4-21 
LOG attribute 4-64 
Local blocks 3-2 

absolute program 3-6 

description 3-2 

establishment 4-30, 32 

relocatable program 3-5 
LOCAL statement 

description 5-31 

example 5-32 

heading 5-13 
Local symbol 

CPU Instruction 8-4 

macro body 5-13 

subprogram 3-1; 4-27 
Locatiai counter 

BSS 4-35 

C(Mitrol 4-36 

description 3-4 

forced upper 3-4 

ORG 4-33 

ORGC 4-33 

special element 2-9; 3-4 

USE 4-30 

USELCM 4-32 
Locaticm field 

listing 11-6 

statement 2-1 
LO control card option 

description 10-4 

related to LIST 4-71 
LOG pseudo 

description 4-36 

example 4-37,53 

location counter changed 3-4 
Logical difference instructlai 8-27 
Logical functions, PPU 9-4 
Logical minus 2-22 
Logical product instruction 8-26 
Logical product and complement instruction 8-28 
Logical shift instruction 8-29, 31, 32 
Logical sum instruction 8-26 
Long add unit 

description 8-4, 6 

instructions 8-38 
LPC Instruction 

description 9-9 

logical function 9-5 
LPN Instruction 

description 9-8 

logical function 9-5 
LT IF operator 4-60 

IFG operator 4-64 
LT instruction 8-24 
LXi instruction 8-29, 31 
, example 2-19 

M base option 4-22.2 
M list option 4-72 
Machine test 4-58 
MACHINE pseudo 4-7 
Macro 

body 5-13 

call 5-18,25 

equivalenced 5-24 
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definition 5-13 

header 5-14 

list control 4-72 

name 2-2; 5-15, 18,25; 6-1 

permissible anywhere 4-2 

processing 5-1, 14 

system defined 4-73; 5-35 

terminator 5-14 
MACROE pseudo 

description 5-24 

example 5-26 

IRP related 5-33 

operation code table entry 6-1 

permissible anywhere 4-2 
MACRO pseudo 

description 5-15 

example 4-29,74; 5-5, 19, 20, 21, 22, 32, 33 34 

IRP related 5-33 

operation code table entry 6-1 

permissible anywhere 4-2 
MAN instruction 9-10 
Maslc instruction 8-3 
Mass storage, system 1-3 
Master list cmtrol 4-71 
MAX pseudo 

description 4-40 

listing 11-6 
! MD instruction 8-51 
MESSAGE macro 12-25 
MI instruction 8-22, 24 
MIC attribute 4-65 
MICCNT pseudo 

description 4-42 

example 4-42 

listing 11-6 

permissible anywhere 4-2 
MICRO 

decimal 7-4 

definition 4-22, 25,26; 7-2 

editing 2-4 

mark 2-4; 5-1 

octal 7-4 

reference 7-1 

size 4-42; 7-2 

system defined 4-17; 7-2,5 
test for 4-65 
MICRO pseudo 

description 7-2 

example 4-42; 5-11; 7-2, 3 

permissible anywhere 4-2 
MI instructions 8-22,24 
MIN pseudo 

description 4-41 

listing 11-6 
Minus as local symbol separator 5-31 
Minus as parameter separator 5-8, 13, 16 24 28 
Minus on listing 11-6 ' 
Minus operator 2-21, 22; 8-4 
Minus sign in location field 

CPU instructiai 3-4, 5; 4-51 

PPU instruction 3-4; 4-51 

VFD instruction 4-51 
MJ instructicHi 8-16 

force upper 3-4 



MJN instruction 

description 9-0 

effect of J 4-9,11 
ML control statement option 10-4 
Mnemonic operation code 

legal operation field entry 2-1 

OPDEF defined 5-27 

search for G-1 
Modifiers, numeric data 2-17 
MODIFY common decks 5-2 
MODLEVEL micro 7-7 
MOVE macro 12-28 
Multiple entry point table 

suppression 4-20 

used for overlays 3-12 
MXi instruction 

description 8-41 

example 2-19; 8-41 
MXN instruction 

description 9-10 

N eject mode 10-4 
N error 11-11 
N list option 4-73 
Name 

block 4-30,32 

different types 2-4 

duplicate code 5-7, 8 

general deseriptiwi 2-4 

IF sequence 4-57 

macro 5-16 

micro 4-22,24,26; 7-2,4,5 
mnemonic operation 6-1 
overlay 4-11,15 
parameter 5-8 
remote code 5-3 
NE instruction 8-24 
NE IF operator 4-60 

IFC operator 4-66 
Nesting, level of 1-3 
NG Instruction 8-22, 24 
NIL pseudo 6-6 

permissible anywhere 4-2 
NIM instruction 9-18 
NJN instruction 

description 9-6 
effect of J 4-9, 10 
NO eject cption 10-4 
NO instructicsi 8-43 
NO LABEL pseudo 
description 4-20 
permissible anywhere 4-2 
NOM instruction 9-18 
NOREF pseudo 4-76 

permissible anywhere 4-2 
Normalize instruction 8-33 
Normalize unit 

description 8-6 
instructions 8-33 
Not equal sign 

parameter separator 5-8, 13 
special character 2-4 
Numeric data 2-16 
NXi instructim 8-33 
NZ instruction 8-22, 24 
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O base 2-18; 4-22.2 
I O error ll-li 
O mode 10-4 
OAM instruction 9-20 
OAN instruction 9-19 
OBj instruction 8-20 
Octal listir^ 11-5 
Octal notation 2-16 
OCTMICpseudo 7-4 

permissible anywhere 4-2 
OLDPLfile 10-3 
Opdef 

body 5-13 
call 5-29 
definition 5-13 
heading 5-13 
list control 4-72,73 
processing 5-14 
system defined 4-17, 33 
OPDEF pseudo 

description 5-27 
example 5-29,30,31,32 
operation code table entry 6-1 
permissible anywhere 4-2 
Operand register 8-8 
Operation code table 6-1 
Operation code value 
CPU 6-7; 8-1 
PPU 6-3; 9-1 
Operation, definition 
compressed 5-1 
duplicated text 5-6 
external text 5-2 
general description 5-1 
macro definition 5-13 
opdef definition 5-13 
remote text 5-3 
system 5-35 
Operation field 
blank 4-46 
description 2-1 
search 6-1 
Operator 

element 2-22 
mnemonic 5-27; 6-3 
register 2-21; 5-28; 6-7 
term 2-22 
Operator with constant 2-13, 16 
GPL file 5-2; 10-3; 12-1 
OPSYN pseudo 

description 6-5 
permissible anywhere 4-2 
ORG pseudo 

description 4-33 
determine blocks 3-1 
establish absolute blocks 3-2- 4-33 
example 4-4,7,13.14,16 
location counter changed 4-33 
origin counter changed 3-3; 4-33 
ORGC pseudo 4-33 
Origin 

multiply entry point 4-3 
overlay 4-12, 15 
program 4-3 
Origin counter 
BSS 4-35 



control 3-3; 4-33, 35 
description 3-3 
final value, absolute 3-6 
final value, relocatable 3-5 
forced upper 3-4 

ORG 4-33 
ORGC 4-33 

special element 2-9* 3-3 
USE 4-30 
OR instruction 8-22 
ORM instruction 9-18 
Overflow error 2-17 
Overlay 

absolute 3-8 

control tables 4-21 

entry point 4-12, 15 

general description 3-6, 8 

level numbers 4-4, 12, 15 

multiple entry point 3-12 

name 4-12, 15 

origin 4-12, 15 

PPU 3-7,9 

primary 3-8, 9, 11, 13; 4-12, 15 
secondary 3-6, 8, 9; 4-12, 15 

P error ll-n 

P numeric data modifier 2-17 

P pagination mode 10-4 

Pack instruction 8-35 

Padding of CPU word 3-4; 4-51- 8 2 

Page heading ll-i 

Page number U-i 

Pagination control 10-4 

Parameter 

actual 5-7,18,25 

embedded 5-18,25 

formal 5-8,13 

indefinitely repeated 5-34 

iterative 5-18,25,34 

substitutable 5-8,13, 16,25.28,34 
Parameter mark 5-9, 13 
Parameter, null 5-9,18,25 
Parameter separator 

actual 5-18,25 

formal 5-8, 13, 16 
Parcel 8-1 
Parentheses 

local symbol separator 5-31 

nested 5-9 

parameter separator 5-8, 13. 16 25 28 
Partial binary * ' 

IDENT type 3-14 

SEG type 3-12 
Pass instruction 

CPU 8-43 

PPU 9-9 
Pass one 

expression evaluation 2-23. 26 28- i 
general description 1-3 •^-J 
maximum test 4-40 
minimum test 4-41 
symbol definition 2-6 
Pass two 

expression evaluation 2-22 26- 3 "l- « o 
general description 1-3 ' ' 
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symbol definition 2-5 

value for MAX 4-40 

value for MIN 4-41 
PC control statement option 10-4 
PCOMMENT micro 7-7 
PD control statement option 10-4 
PERIPH pseudo 

description 4-10 

effect on branch instructions 9-5 

example 4-47; 6-5 

first statement group 4-2 
PJN instruction 

description 9-6 

effect of J' 4-9, 10 
PL instructicHi 8-22, 24 

iPlus in location field 
CPU instruction 3-4 
PPU instructicxi 3-5 
VFD instructicm 4-51 
Plus as parameter separator 5-8, 13, 16, 25, 28 
Plus as local name separator 5-31 
I Plus on listing 11-6; D-2, 3 
Plus operator 2-21, 23; 8-4 
Point 

binary 2-18, 19 
decimal 2-18,19 
octal 2-18,19 

parameter separator 5-8,13,16,25,28 

register designator 2-8 
i Population unit 8-44 
Position counter 

control 4-38,51 

description 3-4 
I special element 2-9; 3-4 

POS pseudo 4-38 
Post radix 2-17 
PPOP 

description 6-3 

example 5-12; 6-5 

permissible anywhere 4-2 
PPU instructions 9-1 

A-register l/O 9-19 

block I/O 9-19 

branch I/O 9-17,18 

branch 9-5 

central read/write 9-15 
channel functicai 9-21 
constant mode 9-8 
designators 9-3 
direct address 9-12 
error stop 9-22 
exchange jump 9-10 
format 9-1 
functions 9-3 

indexed direct address 9-14 
indirect address 9-13 
no address 9-7 
no operation 9-9 
output record flag 9-20 
shift 9-7 
PPU pseudo 

description 4-8 
effect on branch 9-5 
example 4-10,52 
first statement group 4-2 



Prefix table 

comments 4-20 
generation 3-6, 7, 8 

suppression 4-21 
Preradix 2-17 
Program, absolute 3-6; 4-6 
Program execution 10-5 
Program identification 4-2 
Program origin 4-3 
Program, relocatable 3-5 
Program stop instruction 8-10 
Program structure 3-1 
PS control statement option 10-4 
Pseudo instructions 

binary control 4-6 

block counter control 4-30 

conditional assembly 4-57 

data generation 4-45 

definition operation 5-1 

error control 4-69 

first statement group 4-2 

introduction 4-1 

listing control 4-71 

micro 7-1 

mode control 4-21 

operation code table management 6-1 
operation field entry 2-2 
permissible anywhere 4-2 
required 4-2 

subprogram identification 4-2 

subprogram linkage 4-43 

symbol definition 4-38 

types 4-1 
PS instruction 

description 8-10 

force upper 3-4 
PSN instruction 9-9 
PURGDEF pseudo 

description 6-10 

permissible anywhere 4-2 
PURGMAC pseudo 

description 6-7 

example 6-6 

permissible anywhere 4-2 
Push down stack 1-3 
PXi instruction 8-35 

Q to represent expression 5-27; 6-8 
Qualifier, symbol 4-25 

used for definition operations 5-2 
QUAL micro 7-6 
QUAL pseudo 

description 4-25 

example 4-13, 28; 5-22 

permissible anywhere 4-2 

R error 11-11 

R hardware feature code 4-8 

R list qjtion 4-73 

R~ pseudo 

description 4-53 

example 4-54; 5-21 

illegal in PPU program 4-9, 10 
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RAD instruction 

description 9-12 

replace functicai 9-5 
Radix 2-17 
RAI instruction 

description 9-13 

replace function 9-5 
RAM instruction 

description 9-15 

replace function 9-5 
Real-time clock set instruction 8-18 
Record name, external text 5-3 
Recursion level 1-4; 5-1 
Recursion stack 1-4; 5-1 
Reference 

macro 5-18 

macroe 5-24 

nested 5-1 

opdef 5-27 
Reference table, symbolic 11-13 
Registers, CPU 2-8; 8-7 
Register designators 

CTOP 6-7 

description 2-8; 8-7 

not symbols 2-5 

OPDEF 5-27 

OPSYN 6-5 

PURGDEF 6-10 
RE instruction 

description 8-13 

force upper 3-4 
READC macro 12-28 
READH macro 12-28 
READO macro 12-29 
READS macro 12-29 
READW macro 12-29 
RECALL macro 12-30 
RE L attribute 4-64 
Relocatable program structure 3-5 
Relocatable test 4-64 
Remote assembly 5-3 
Repeat count 

DUP 5-7 

replication 4-55 
REPpseudo 4-55 
RE PC pseudo 4-55 
RE PI pseudo 

example 4-55 

description 4-55 

illegal if absolute 4-6,9,10 
RE PL table 

result of BSSZ 4-46 

result of REP,REPC, or RE PI 4-55 

written by SEGMENT 4-15 
Replace functions, PPU 9-5 
Replication of code 4-55 
Return jump, CPU 8-11 
RFN instruction 9-20 
RI instruction 8-18 
Right shift 8-30, 32 
RJ instruction 

description 8-12 

example 4-31; 5-21; 8-12 

force upper 3-5 



RJM instruction 9-6 
RL instruction 8-14 
RMT pseudo 

description 5-3 

example 5-5, 6 

permissible anywhere 4-2 
RO instruction 8-19 
Round and normalize instruction 8-34 

RPN instructions 9-11 
RXi instructions 

add 8-38 

divide 8-42 

multiply 8-39 
RXj instruction 8-17 

S list option 4-73 

S numeric data modifier 2-18 

S storage flag 11-14 

S system text mode 10-5 

SAi instructions 

description 8-44 

example 2-15, 16, 19; 4-31, 36; 5-22, 33; 8-45 
SBD instruction 

arithmetic function 9-4 

description 9-12 
SBI instruction 

arithmetic function 9-4 

description 9-13 
SBi instructions 

description 8-46 

example 2-9, 12; 8-47 
SBM instruction 

arithmetic functicai 9-4 

description 9-15 
SBN instruction 

arithmetic function 9-4 

description 9-8 
Scale, binary 2-18 
SCM blank common 3-3 
SCM labeled common 3-2 
SCN instruction 

description 9-8 

logical function 9-5 
SEG pseudo 

binary generation 3-12 

description 4-15 

example 4-16 

force upper 3-4 

illegal in PPU program 4-9, 10 
SEGMENT pseudo 

binary generation 3-8, 9, 10, 12 

description 4-16 

example 4-17 

force upper 3-4 

illegal in PPU program 4-9, 10 

overlay structure 3-10, 12 
Semicolon in definition 5-8,13 
SEQUENCE micro 7-7 
Sequencing 

listing 11-7 

statement 2-1 
SET attribute 4-64 
Set instructions 8-44 thru 8-49 
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SET pseudo 

description 4-39 
example 2-9, 20; 5-11, 22 
listing 11-6 

Shift 

description of unit 8-3,6 
§ CPU instructicms 8-29 thru 8-32, 41 

PPU instructions 9-7 
SHN instruction 9-7 
Short jump limit 4-9, 11 
Short list 10-4 
Single precision instructions 
§ add rounded 8-37 

add unrounded 8-36 

divide rounded 8-42 

divide unrounded 8-42 

multiply rounded 8-39 

multiply unrounded 8-39 
SKIP pseudo 

description 4-68 

permissible anywhere 4-2 
Slant bar 

local symbol separator 5-31 

operator 2-22 

parameter separator 5-8,13,16,24,28 
SOD instruction 

description 9-12 

replace function 9-5 
SOI instruction 

description 9-13 

replace function 9-5 
SOM instruction 

description 9-15 

replace function 9-5 
Space, embedded (see blank) 
SPACE pseudo 

description 4-74 

permissible anywhere 4-2 
Special elements 

FORTRAN call 2-9 

general description 2-9 

in variable field 2-2 

location counter 3-4 
I origin counter 3-3 

position counter 3-4 
SST attribute 4-65 
SST pseudo 4-43 

example 4-13 

permissible anywhere 4-2 
Stack, recursion 1-4; 5-1 
Statement 

coding conventions 2-3 

comments 2-2 

compressed 5-1 

continuation 2-2 

external source 5-2 

first column 2-1 

first group 4-1 

format 2-1 

listing 11-5 

number assembled 11-8 
size 2-1 

source of 5-1; 10-3 
Statistics, assembler 11-8 
) STD instruction 

f data transmission function 9-3 

description 9-12 



STEXT pseudo 

description 4-17 

example 4-19 

first statement group 4-2 
STI instructim 

data transmission function 9-3 

description 9-13 
STM instruction 

data transmission function 9-3 

description 9-15 
STOPDUP pseudo 

description 5-9 

example 5-11 
Storage reservation 4-35, 46 
String, character 

comparison 4-66 

data generation 4-47 

delimited 2-11,14 | 

empty 2-14 

micro 2-4 

notation 2-13 
Strong external 2-7 
Subprogram length 3-5 
Substituticai, micro 7-1 
Subsubtitle 

CTEXT 4-77 

EJECT 4-74 

listing of 11-1 

QUAL 4-25 

SPACE 4-74 

TITLE 4-75 

TTL 4-76 
Subtitle 

CTEXT 4-77 

listing of 11-1 

TITLE 4-75 
SXi instructlcxi 

description 8-48 | 

example 2-15,19; 5-21,31; 8-48 
Symbol 

attribute 2-6; 4-37, 64 

created 5-32 

default 2-7 

definition 2-5; 4-38 

duplicate 2-6 

entry point 2-6 

external 2-7 

invented 5-32; 11-8 | 

literals 2-6 

local to macro 5-13, 31 

local to QUAL 3-1 

location field 2-6 

lost 11-8,13 

number defined 11-8 

number referenced 11-8 

previously defined 2-7 

qualified 2-7; 4-25 

redefinition 4-27, 39 | 

system-defined 2-6; 4-43 

undefined 2-7 

value 2-6; 4-37 
Symbol qualifier listed 11-1 
Symbol table 

clearing 3-10, 12 | 

system text 4-17 
Symbolic reference table 

address reference 4-78 
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I detailed description 11-12 

general descriptim 4-71 

generation 1-3 

list ccmtrol 4-71; 10-3 

omit symbol 4-76 
Synonymous operation 

CPU 6-10 

mnemonic 6-5 

PPU 6-5 

syntactic 6-7 
Syntax definition 5-27; 6-7,10 
Syntax search 6-1 
SYSTEM macro 12-30 
System text 4-19 
SYSTEXT option 10-4 

related to G mode 10-4 

related to STEXT 4-17 

T list option 4-73 
Table 

operation code 6-1 

symbolic reference 11-12 

USE 4-30 
TBj instruction 8-18 
Term 2-22 
Term operator 2-22 
Terminator, macro 5-13 
Test symbol attribute 4-64 
Time limit 10-1 
TIME micro 7-6 
Time of assembly 11-1 
Title 

ES 8-11 

IDENT 4-3 

listing of 11-1 

PS 8-10 

TITLE 4-75 
TITLE pseudo 4-75 

permissible anywhere 4-2 
Transfer symbol 4-4 
Transmit instruction 8-25 
Truncation, character data 2-13 

expression value 2-26 
TTL pseudo 4-76 

permissible anywhere 4-2 

U error 11-11 
UJN instruction 

effect of J 4-9, 10 

description 9-6 
Unconditional jump 

CPU 8-20 

PPU 9-6 
Underflow error 2-18 
Unpack instruction 8-35 
USE pseudo 

change blocks 3-1, 2, 3, 5; 4-30 

description 4-30 

establish common blocks 3-2, 3; 4-30 
establish local blocks 3-2; 4-30 
example 4-17,28,29,31,34,36 

USE table 

entry 4-30, 32, 33 
reinitialization 3-10, 12; 4-11 

USELCM pseudo 

description 4-32 



establish common blocks 3-2, 3 
example 4-33 

illegal in PPU program 4-9, 10 
USER control statement 10-7 
UXi instruction 8-34 

V error 11-11 
Value, numeric 2-17 
Variable field 2-2 
Variable field definitim 4-51 
VFD pseudo 

description 4-51 

example 2-15; 4-23, 28, 31, 52; 5-22 

WE instructicai 

description 8-13 

force upper 3-4 
Weak external 2-7 
WL instructicHi 8-14 
WRITEC macro 12-31 
WRITER macro 12-31 
WRITE O macro 12-31 
WRITES macro 12-32 
WRITEW macro 12-32 
WXj instruction 8-17 

X external flag 4-45; 11-6 
X external text mode 10-5 
X file option 

description 10-5 

XTEXT default 5-3 
X hardware feature code 4-8 
X list option 4-73 
X register 

conditional instructions 8-21 

description 8-3 

designator 2-8 

setting 8-48 
XJ instruction 

description 8-15 

force upper 3-4 
XREF pseudo 

description 4-78 

permissible anywhere 4-2 
XTEXT pseudo 5-1 

related to CTEXT/ENDX 4-77 
XTEXT source 10-5 

Zero block 

absolute program 3-2, 6, 7 

description 3-2 

relocatable program 3-5 
Zeroed words 4-46 
Zero fill 2-14, 4-51 
Zero guaranteed 

data item 2-14 

DIS item 4-48 
ZJN instruction 

description 9-6 

effect of J 4-9, 10 
ZR instruction 

description 8-22,24 

force upper 3-4 
ZXi instruction 8-34 
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